/ MacTech 1 to 12 / MacTech-vol-1-12.toast / Source / develop™ Technical Journal / develop Issue 27 code / Internet_Config_Assistant.sit / Internet Config Assistant / headers / ICCAPI.h

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 08 49 43 43 41 50 49 | 2e 68 00 00 00 00 00 00 |..ICCAPI|.h......|
|00000010| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 43 57 49 | 45 01 00 00 00 00 00 00 |.TEXTCWI|E.......|
|00000050| 00 00 00 00 00 6c 98 00 | 00 01 c8 ac 8c fb 08 ac |.....l..|........|
|00000060| 8c fb 08 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 5d 94 00 00 |........|....]...|
|00000080| 2f 2a 20 a5 a5 a5 53 74 | 61 72 74 20 48 65 61 64 |/* ...St|art Head|
|00000090| 65 72 a5 a5 a5 20 2a 2f | 0d 0d 2f 2a 20 46 69 6c |er... */|../* Fil|
|000000a0| 65 3a 20 20 20 20 20 20 | 20 20 20 49 43 43 41 50 |e:      |   ICCAP|
|000000b0| 49 2e 68 0d 20 2a 20 47 | 65 6e 65 72 61 74 65 64 |I.h. * G|enerated|
|000000c0| 20 62 79 3a 20 31 2e 30 | 64 34 0d 20 2a 20 46 6f | by: 1.0|d4. * Fo|
|000000d0| 72 3a 20 20 20 20 20 20 | 20 20 20 20 49 43 20 31 |r:      |    IC 1|
|000000e0| 2e 32 0d 20 2a 20 4f 6e | 3a 20 20 20 20 20 20 20 |.2. * On|:       |
|000000f0| 20 20 20 20 4d 6f 6e 64 | 61 79 2c 20 32 35 20 53 |    Mond|ay, 25 S|
|00000100| 65 70 74 65 6d 62 65 72 | 20 31 39 39 35 2c 20 31 |eptember| 1995, 1|
|00000110| 39 3a 32 38 3a 31 32 0d | 20 2a 20 0d 20 2a 20 54 |9:28:12.| * . * T|
|00000120| 68 69 73 20 66 69 6c 65 | 20 69 73 20 70 61 72 74 |his file| is part|
|00000130| 20 6f 66 20 74 68 65 20 | 49 6e 74 65 72 6e 65 74 | of the |Internet|
|00000140| 20 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 20 73 | Configu|ration s|
|00000150| 79 73 74 65 6d 20 61 6e | 64 0d 20 2a 20 69 73 20 |ystem an|d. * is |
|00000160| 70 6c 61 63 65 64 20 69 | 6e 20 74 68 65 20 70 75 |placed i|n the pu|
|00000170| 62 6c 69 63 20 64 6f 6d | 61 69 6e 20 66 6f 72 20 |blic dom|ain for |
|00000180| 74 68 65 20 62 65 6e 65 | 66 69 74 20 6f 66 20 61 |the bene|fit of a|
|00000190| 6c 6c 2e 0d 20 2a 2f 0d | 0d 2f 2a 20 a5 a5 a5 45 |ll.. */.|./* ...E|
|000001a0| 6e 64 20 48 65 61 64 65 | 72 a5 a5 a5 20 2a 2f 0d |nd Heade|r... */.|
|000001b0| 0d 2f 2a 0d 09 49 4d 50 | 4f 52 54 41 4e 54 20 4e |./*..IMP|ORTANT N|
|000001c0| 4f 54 45 53 20 41 42 4f | 55 54 20 54 48 45 20 43 |OTES ABO|UT THE C|
|000001d0| 20 43 4f 4e 56 45 52 53 | 49 4f 4e 0d 09 2d 2d 2d | CONVERS|ION..---|
|000001e0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|000001f0| 2d 2d 2d 2d 2d 2d 2d 2d | 2d 2d 2d 2d 2d 2d 2d 2d |--------|--------|
|00000200| 2d 2d 2d 0d 09 0d 09 6f | 20 50 61 73 63 61 6c 20 |---....o| Pascal |
|00000210| 22 76 61 72 22 20 70 61 | 72 61 6d 65 74 65 72 73 |"var" pa|rameters|
|00000220| 20 61 72 65 20 63 6f 6e | 76 65 72 74 65 64 20 66 | are con|verted f|
|00000230| 72 6f 6d 20 22 76 61 72 | 20 78 20 3a 20 79 22 20 |rom "var| x : y" |
|00000240| 74 6f 20 22 79 20 2a 78 | 22 2e 20 20 54 68 69 73 |to "y *x|".  This|
|00000250| 0d 09 20 20 6d 65 61 6e | 73 20 74 68 61 74 20 77 |..  mean|s that w|
|00000260| 68 65 6e 20 79 6f 75 20 | 73 65 65 20 74 68 65 20 |hen you |see the |
|00000270| 70 61 72 61 6d 65 74 65 | 72 20 22 79 20 2a 78 22 |paramete|r "y *x"|
|00000280| 20 79 6f 75 20 73 68 6f | 75 6c 64 20 62 65 20 61 | you sho|uld be a|
|00000290| 77 61 72 65 20 74 68 61 | 74 0d 09 09 09 79 6f 75 |ware tha|t....you|
|000002a0| 20 2a 63 61 6e 6e 6f 74 | 20 70 61 73 73 20 69 6e | *cannot| pass in|
|000002b0| 20 6e 69 6c 2a 2e 20 20 | 49 6e 20 66 75 74 75 72 | nil*.  |In futur|
|000002c0| 65 20 74 68 69 73 20 72 | 65 73 74 72 69 63 74 69 |e this r|estricti|
|000002d0| 6f 6e 20 6d 61 79 20 62 | 65 20 65 61 73 65 64 2c |on may b|e eased,|
|000002e0| 0d 09 09 09 65 73 70 65 | 63 69 61 6c 6c 79 20 66 |....espe|cially f|
|000002f0| 6f 72 20 74 68 65 20 61 | 74 74 72 20 70 61 72 61 |or the a|ttr para|
|00000300| 6d 65 74 65 72 20 74 6f | 20 49 43 47 65 74 50 72 |meter to| ICGetPr|
|00000310| 65 66 2e 20 20 50 61 72 | 61 6d 65 74 65 72 73 20 |ef.  Par|ameters |
|00000320| 77 68 65 72 65 20 6e 69 | 6c 0d 09 09 09 69 73 20 |where ni|l....is |
|00000330| 6c 65 67 61 6c 20 61 72 | 65 20 64 65 63 6c 61 72 |legal ar|e declar|
|00000340| 65 64 20 75 73 69 6e 67 | 20 74 68 65 20 65 78 70 |ed using| the exp|
|00000350| 6c 69 63 69 74 20 70 6f | 69 6e 74 65 72 20 74 79 |licit po|inter ty|
|00000360| 70 65 2c 20 69 65 20 22 | 79 50 74 72 20 78 22 2e |pe, ie "|yPtr x".|
|00000370| 0d 0d 09 6f 20 53 74 72 | 69 6e 67 73 20 61 72 65 |...o Str|ings are|
|00000380| 20 2a 50 61 73 63 61 6c | 2a 20 73 74 72 69 6e 67 | *Pascal|* string|
|00000390| 73 2e 20 20 54 68 69 73 | 20 6d 65 61 6e 73 20 74 |s.  This| means t|
|000003a0| 68 61 74 20 74 68 65 79 | 20 6d 75 73 74 20 62 65 |hat they| must be|
|000003b0| 20 77 6f 72 64 20 61 6c | 69 67 6e 65 64 2e 0d 09 | word al|igned...|
|000003c0| 09 4d 50 57 20 61 6e 64 | 20 54 68 69 6e 6b 20 43 |.MPW and| Think C|
|000003d0| 20 64 6f 20 74 68 69 73 | 20 61 75 74 6f 6d 61 74 | do this| automat|
|000003e0| 69 63 61 6c 6c 79 2e 20 | 20 54 68 65 20 6c 61 73 |ically. | The las|
|000003f0| 74 20 74 69 6d 65 20 49 | 20 63 68 65 63 6b 2c 20 |t time I| check, |
|00000400| 4d 65 74 72 6f 77 65 72 | 6b 73 0d 09 09 43 20 64 |Metrower|ks...C d|
|00000410| 6f 65 73 20 6e 6f 74 2e | 20 20 49 66 20 69 74 20 |oes not.|  If it |
|00000420| 73 74 69 6c 6c 20 64 6f | 65 73 6e 27 74 2c 20 74 |still do|esn't, t|
|00000430| 68 65 6e 20 49 4d 48 4f | 20 69 74 27 73 20 61 20 |hen IMHO| it's a |
|00000440| 62 75 67 20 69 6e 20 74 | 68 65 69 72 20 63 6f 6d |bug in t|heir com|
|00000450| 70 69 6c 65 72 0d 09 09 | 61 6e 64 20 79 6f 75 20 |piler...|and you |
|00000460| 73 68 6f 75 6c 64 20 72 | 65 70 6f 72 74 20 69 74 |should r|eport it|
|00000470| 20 74 6f 20 74 68 65 6d | 2e 0d 0d 09 6f 20 54 68 | to them|....o Th|
|00000480| 65 20 63 61 6e 6f 6e 69 | 63 61 6c 20 49 6e 74 65 |e canoni|cal Inte|
|00000490| 72 6e 65 74 20 43 6f 6e | 66 69 67 20 69 6e 74 65 |rnet Con|fig inte|
|000004a0| 72 66 61 63 65 20 69 73 | 20 64 65 66 69 6e 65 64 |rface is| defined|
|000004b0| 20 69 6e 20 50 61 73 63 | 61 6c 2e 20 20 54 68 65 | in Pasc|al.  The|
|000004c0| 73 65 0d 09 09 68 65 61 | 64 65 72 73 20 68 61 76 |se...hea|ders hav|
|000004d0| 65 20 6e 6f 74 20 62 65 | 65 6e 20 74 68 6f 72 6f |e not be|en thoro|
|000004e0| 75 67 68 6c 79 20 74 65 | 73 74 65 64 2e 20 20 49 |ughly te|sted.  I|
|000004f0| 66 20 74 68 65 72 65 20 | 69 73 20 61 20 63 6f 6e |f there |is a con|
|00000500| 66 6c 69 63 74 20 62 65 | 74 77 65 65 6e 0d 09 09 |flict be|tween...|
|00000510| 74 68 65 73 65 20 68 65 | 61 64 65 72 73 20 61 6e |these he|aders an|
|00000520| 64 20 74 68 65 20 50 61 | 73 63 61 6c 20 69 6e 74 |d the Pa|scal int|
|00000530| 65 72 66 61 63 65 73 2c | 20 74 68 65 20 50 61 73 |erfaces,| the Pas|
|00000540| 63 61 6c 20 73 68 6f 75 | 6c 64 20 74 61 6b 65 20 |cal shou|ld take |
|00000550| 70 72 65 63 65 64 65 6e | 63 65 2e 0d 2a 2f 0d 0d |preceden|ce..*/..|
|00000560| 2f 2a 20 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |/* /////|////////|
|00000570| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000580| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000590| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|000005a0| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|000005b0| 2f 2f 2f 2f 20 2a 2f 0d | 0d 23 69 66 6e 64 65 66 |//// */.|.#ifndef|
|000005c0| 20 5f 5f 49 43 43 41 50 | 49 5f 5f 0d 23 64 65 66 | __ICCAP|I__.#def|
|000005d0| 69 6e 65 20 5f 5f 49 43 | 43 41 50 49 5f 5f 0d 0d |ine __IC|CAPI__..|
|000005e0| 23 69 66 6e 64 65 66 20 | 5f 5f 54 59 50 45 53 5f |#ifndef |__TYPES_|
|000005f0| 5f 0d 23 69 6e 63 6c 75 | 64 65 20 3c 54 79 70 65 |_.#inclu|de <Type|
|00000600| 73 2e 68 3e 0d 23 65 6e | 64 69 66 0d 0d 23 69 66 |s.h>.#en|dif..#if|
|00000610| 6e 64 65 66 20 5f 5f 46 | 49 4c 45 53 5f 5f 0d 23 |ndef __F|ILES__.#|
|00000620| 69 6e 63 6c 75 64 65 20 | 3c 46 69 6c 65 73 2e 68 |include |<Files.h|
|00000630| 3e 0d 23 65 6e 64 69 66 | 0d 0d 23 69 66 6e 64 65 |>.#endif|..#ifnde|
|00000640| 66 20 5f 5f 43 4f 4d 50 | 4f 4e 45 4e 54 53 5f 5f |f __COMP|ONENTS__|
|00000650| 0d 23 69 6e 63 6c 75 64 | 65 20 3c 43 6f 6d 70 6f |.#includ|e <Compo|
|00000660| 6e 65 6e 74 73 2e 68 3e | 0d 23 65 6e 64 69 66 0d |nents.h>|.#endif.|
|00000670| 0d 23 69 66 6e 64 65 66 | 20 5f 5f 49 43 54 59 50 |.#ifndef| __ICTYP|
|00000680| 45 53 5f 5f 0d 23 69 6e | 63 6c 75 64 65 20 3c 49 |ES__.#in|clude <I|
|00000690| 43 54 79 70 65 73 2e 68 | 3e 0d 23 65 6e 64 69 66 |CTypes.h|>.#endif|
|000006a0| 0d 0d 23 69 66 6e 64 65 | 66 20 5f 5f 49 43 4b 45 |..#ifnde|f __ICKE|
|000006b0| 59 53 5f 5f 0d 23 69 6e | 63 6c 75 64 65 20 3c 49 |YS__.#in|clude <I|
|000006c0| 43 4b 65 79 73 2e 68 3e | 0d 23 65 6e 64 69 66 0d |CKeys.h>|.#endif.|
|000006d0| 0d 2f 2a 20 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |./* ////|////////|
|000006e0| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|000006f0| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000700| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000710| 2f 2f 2f 2f 2f 2f 2f 2f | 2f 2f 2f 2f 2f 2f 2f 2f |////////|////////|
|00000720| 2f 2f 2f 2f 20 2a 2f 0d | 0d 65 6e 75 6d 20 7b 0d |//// */.|.enum {.|
|00000730| 09 69 6e 74 65 72 6e 65 | 74 43 6f 6e 66 69 67 75 |.interne|tConfigu|
|00000740| 72 61 74 69 6f 6e 43 6f | 6d 70 6f 6e 65 6e 74 54 |rationCo|mponentT|
|00000750| 79 70 65 20 3d 20 27 50 | 52 45 46 27 2c 09 09 09 |ype = 'P|REF',...|
|00000760| 09 09 09 09 2f 2a 20 74 | 68 65 20 63 6f 6d 70 6f |..../* t|he compo|
|00000770| 6e 65 6e 74 20 74 79 70 | 65 20 2a 2f 0d 09 69 6e |nent typ|e */..in|
|00000780| 74 65 72 6e 65 74 43 6f | 6e 66 69 67 75 72 61 74 |ternetCo|nfigurat|
|00000790| 69 6f 6e 43 6f 6d 70 6f | 6e 65 6e 74 53 75 62 54 |ionCompo|nentSubT|
|000007a0| 79 70 65 20 3d 20 27 49 | 43 41 70 27 2c 09 09 09 |ype = 'I|CAp',...|
|000007b0| 09 09 20 20 2f 2a 20 74 | 68 65 20 63 6f 6d 70 6f |..  /* t|he compo|
|000007c0| 6e 65 6e 74 20 73 75 62 | 74 79 70 65 20 2a 2f 0d |nent sub|type */.|
|000007d0| 09 69 6e 74 65 72 6e 65 | 74 43 6f 6e 66 69 67 75 |.interne|tConfigu|
|000007e0| 72 61 74 69 6f 6e 43 6f | 6d 70 6f 6e 65 6e 74 49 |rationCo|mponentI|
|000007f0| 6e 74 65 72 66 61 63 65 | 56 65 72 73 69 6f 6e 30 |nterface|Version0|
|00000800| 20 3d 20 30 78 30 30 30 | 30 30 30 30 30 4c 2c 0d | = 0x000|00000L,.|
|00000810| 09 69 6e 74 65 72 6e 65 | 74 43 6f 6e 66 69 67 75 |.interne|tConfigu|
|00000820| 72 61 74 69 6f 6e 43 6f | 6d 70 6f 6e 65 6e 74 49 |rationCo|mponentI|
|00000830| 6e 74 65 72 66 61 63 65 | 56 65 72 73 69 6f 6e 31 |nterface|Version1|
|00000840| 20 3d 20 30 78 30 30 30 | 31 30 30 30 30 4c 2c 0d | = 0x000|10000L,.|
|00000850| 09 69 6e 74 65 72 6e 65 | 74 43 6f 6e 66 69 67 75 |.interne|tConfigu|
|00000860| 72 61 74 69 6f 6e 43 6f | 6d 70 6f 6e 65 6e 74 49 |rationCo|mponentI|
|00000870| 6e 74 65 72 66 61 63 65 | 56 65 72 73 69 6f 6e 32 |nterface|Version2|
|00000880| 20 3d 20 30 78 30 30 30 | 32 30 30 30 30 4c 2c 0d | = 0x000|20000L,.|
|00000890| 09 2f 2a 20 63 75 72 72 | 65 6e 74 20 76 65 72 73 |./* curr|ent vers|
|000008a0| 69 6f 6e 20 6e 75 6d 62 | 65 72 20 69 73 20 76 65 |ion numb|er is ve|
|000008b0| 72 73 69 6f 6e 20 32 20 | 2a 2f 0d 09 69 6e 74 65 |rsion 2 |*/..inte|
|000008c0| 72 6e 65 74 43 6f 6e 66 | 69 67 75 72 61 74 69 6f |rnetConf|iguratio|
|000008d0| 6e 43 6f 6d 70 6f 6e 65 | 6e 74 49 6e 74 65 72 66 |nCompone|ntInterf|
|000008e0| 61 63 65 56 65 72 73 69 | 6f 6e 20 3d 20 69 6e 74 |aceVersi|on = int|
|000008f0| 65 72 6e 65 74 43 6f 6e | 66 69 67 75 72 61 74 69 |ernetCon|figurati|
|00000900| 6f 6e 43 6f 6d 70 6f 6e | 65 6e 74 49 6e 74 65 72 |onCompon|entInter|
|00000910| 66 61 63 65 56 65 72 73 | 69 6f 6e 32 0d 7d 3b 0d |faceVers|ion2.};.|
|00000920| 0d 74 79 70 65 64 65 66 | 20 43 6f 6d 70 6f 6e 65 |.typedef| Compone|
|00000930| 6e 74 49 6e 73 74 61 6e | 63 65 20 69 6e 74 65 72 |ntInstan|ce inter|
|00000940| 6e 65 74 43 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e |netConfi|guration|
|00000950| 43 6f 6d 70 6f 6e 65 6e | 74 3b 0d 0d 23 69 66 64 |Componen|t;..#ifd|
|00000960| 65 66 20 5f 5f 63 70 6c | 75 73 70 6c 75 73 0d 65 |ef __cpl|usplus.e|
|00000970| 78 74 65 72 6e 20 22 43 | 22 20 7b 0d 23 65 6e 64 |xtern "C|" {.#end|
|00000980| 69 66 20 5f 5f 63 70 6c | 75 73 70 6c 75 73 0d 0d |if __cpl|usplus..|
|00000990| 2f 2a 20 a5 a5 a5 53 74 | 61 72 74 20 49 43 43 41 |/* ...St|art ICCA|
|000009a0| 50 49 2e 68 a5 a5 a5 20 | 2a 2f 0d 0d 2f 2a 20 2a |PI.h... |*/../* *|
|000009b0| 2a 2a 2a 2a 20 53 74 61 | 72 74 69 6e 67 20 55 70 |**** Sta|rting Up|
|000009c0| 20 61 6e 64 20 53 68 75 | 74 74 69 6e 67 20 44 6f | and Shu|tting Do|
|000009d0| 77 6e 20 2a 2a 2a 2a 2a | 20 2a 2f 0d 0d 70 61 73 |wn *****| */..pas|
|000009e0| 63 61 6c 20 49 43 45 72 | 72 6f 72 20 49 43 43 53 |cal ICEr|ror ICCS|
|000009f0| 74 61 72 74 28 69 6e 74 | 65 72 6e 65 74 43 6f 6e |tart(int|ernetCon|
|00000a00| 66 69 67 75 72 61 74 69 | 6f 6e 43 6f 6d 70 6f 6e |figurati|onCompon|
|00000a10| 65 6e 74 20 2a 69 6e 73 | 74 2c 20 4f 53 54 79 70 |ent *ins|t, OSTyp|
|00000a20| 65 20 63 72 65 61 74 6f | 72 29 3b 0d 20 20 2f 2a |e creato|r);.  /*|
|00000a30| 20 43 61 6c 6c 20 74 68 | 69 73 20 61 74 20 61 70 | Call th|is at ap|
|00000a40| 70 6c 69 63 61 74 69 6f | 6e 20 69 6e 69 74 69 61 |plicatio|n initia|
|00000a50| 6c 69 73 61 74 69 6f 6e | 2e 20 53 65 74 20 63 72 |lisation|. Set cr|
|00000a60| 65 61 74 6f 72 20 74 6f | 20 79 6f 75 72 20 61 70 |eator to| your ap|
|00000a70| 70 6c 69 63 61 74 69 6f | 6e 0d 20 20 20 2a 20 63 |plicatio|n.   * c|
|00000a80| 72 65 61 74 6f 72 20 74 | 6f 20 61 6c 6c 6f 77 20 |reator t|o allow |
|00000a90| 66 6f 72 20 66 75 74 75 | 72 65 20 65 78 70 61 6e |for futu|re expan|
|00000aa0| 73 69 6f 6e 20 6f 66 20 | 74 68 65 20 49 43 20 73 |sion of |the IC s|
|00000ab0| 79 73 74 65 6d 2e 20 52 | 65 74 75 72 6e 73 0d 20 |ystem. R|eturns. |
|00000ac0| 20 20 2a 20 69 6e 73 74 | 20 61 73 20 61 20 63 6f |  * inst| as a co|
|00000ad0| 6e 6e 65 63 74 69 6f 6e | 20 74 6f 20 74 68 65 20 |nnection| to the |
|00000ae0| 49 43 20 73 79 73 74 65 | 6d 2e 0d 20 20 20 2a 2f |IC syste|m..   */|
|00000af0| 0d 0d 70 61 73 63 61 6c | 20 49 43 45 72 72 6f 72 |..pascal| ICError|
|00000b00| 20 49 43 43 53 74 6f 70 | 28 69 6e 74 65 72 6e 65 | ICCStop|(interne|
|00000b10| 74 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 43 6f |tConfigu|rationCo|
|00000b20| 6d 70 6f 6e 65 6e 74 20 | 69 6e 73 74 29 3b 0d 20 |mponent |inst);. |
|00000b30| 20 2f 2a 20 49 74 20 69 | 73 20 69 6c 6c 65 67 61 | /* It i|s illega|
|00000b40| 6c 20 74 6f 20 63 61 6c | 6c 20 74 68 69 73 20 72 |l to cal|l this r|
|00000b50| 6f 75 74 69 6e 65 20 69 | 6e 73 69 64 65 20 61 20 |outine i|nside a |
|00000b60| 49 43 42 65 67 69 6e 2f | 45 6e 64 20 70 61 69 72 |ICBegin/|End pair|
|00000b70| 2e 0d 20 20 20 2a 20 43 | 61 6c 6c 20 74 68 69 73 |..   * C|all this|
|00000b80| 20 61 74 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 | at appl|ication |
|00000b90| 69 6e 69 74 69 61 6c 69 | 73 61 74 69 6f 6e 2c 20 |initiali|sation, |
|00000ba0| 61 66 74 65 72 20 77 68 | 69 63 68 20 69 6e 73 74 |after wh|ich inst|
|00000bb0| 0d 20 20 20 2a 20 69 73 | 20 6e 6f 20 6c 6f 6e 67 |.   * is| no long|
|00000bc0| 65 72 20 76 61 6c 69 64 | 20 63 6f 6e 6e 65 63 74 |er valid| connect|
|00000bd0| 69 6f 6e 20 74 6f 20 49 | 43 2e 0d 20 20 20 2a 2f |ion to I|C..   */|
|00000be0| 0d 0d 2f 2a 20 2a 2a 2a | 2a 2a 20 53 70 65 63 69 |../* ***|** Speci|
|00000bf0| 66 79 69 6e 67 20 61 20 | 43 6f 6e 66 69 67 75 72 |fying a |Configur|
|00000c00| 61 74 69 6f 6e 20 2a 2a | 2a 2a 2a 20 2a 2f 0d 0d |ation **|*** */..|
|00000c10| 70 61 73 63 61 6c 20 49 | 43 45 72 72 6f 72 20 49 |pascal I|CError I|
|00000c20| 43 43 46 69 6e 64 43 6f | 6e 66 69 67 46 69 6c 65 |CCFindCo|nfigFile|
|00000c30| 28 69 6e 74 65 72 6e 65 | 74 43 6f 6e 66 69 67 75 |(interne|tConfigu|
|00000c40| 72 61 74 69 6f 6e 43 6f | 6d 70 6f 6e 65 6e 74 20 |rationCo|mponent |
|00000c50| 69 6e 73 74 2c 20 73 68 | 6f 72 74 20 63 6f 75 6e |inst, sh|ort coun|
|00000c60| 74 2c 20 49 43 44 69 72 | 53 70 65 63 41 72 72 61 |t, ICDir|SpecArra|
|00000c70| 79 50 74 72 20 66 6f 6c | 64 65 72 73 29 0d 46 49 |yPtr fol|ders).FI|
|00000c80| 56 45 57 4f 52 44 49 4e | 4c 49 4e 45 28 30 78 32 |VEWORDIN|LINE(0x2|
|00000c90| 46 33 43 2c 20 36 2c 20 | 32 2c 20 30 78 37 30 30 |F3C, 6, |2, 0x700|
|00000ca0| 30 2c 20 30 78 41 38 32 | 41 29 3b 0d 20 20 2f 2a |0, 0xA82|A);.  /*|
|00000cb0| 20 49 74 20 69 73 20 69 | 6c 6c 65 67 61 6c 20 74 | It is i|llegal t|
|00000cc0| 6f 20 63 61 6c 6c 20 74 | 68 69 73 20 72 6f 75 74 |o call t|his rout|
|00000cd0| 69 6e 65 20 69 6e 73 69 | 64 65 20 61 20 49 43 42 |ine insi|de a ICB|
|00000ce0| 65 67 69 6e 2f 45 6e 64 | 20 70 61 69 72 2e 0d 20 |egin/End| pair.. |
|00000cf0| 20 20 2a 20 43 61 6c 6c | 20 74 6f 20 63 6f 6e 66 |  * Call| to conf|
|00000d00| 69 67 75 72 65 20 74 68 | 69 73 20 63 6f 6e 6e 65 |igure th|is conne|
|00000d10| 63 74 69 6f 6e 20 74 6f | 20 49 43 2e 0d 20 20 20 |ction to| IC..   |
|00000d20| 2a 20 53 65 74 20 63 6f | 75 6e 74 20 61 73 20 74 |* Set co|unt as t|
|00000d30| 68 65 20 6e 75 6d 62 65 | 72 20 6f 66 20 76 61 6c |he numbe|r of val|
|00000d40| 69 64 20 65 6c 65 6d 65 | 6e 74 73 20 69 6e 20 66 |id eleme|nts in f|
|00000d50| 6f 6c 64 65 72 73 2e 0d | 20 20 20 2a 20 53 65 74 |olders..|   * Set|
|00000d60| 20 66 6f 6c 64 65 72 73 | 20 74 6f 20 61 20 70 6f | folders| to a po|
|00000d70| 69 6e 74 65 72 20 74 6f | 20 74 68 65 20 66 6f 6c |inter to| the fol|
|00000d80| 64 65 72 73 20 74 6f 20 | 73 65 61 72 63 68 2e 0d |ders to |search..|
|00000d90| 20 20 20 2a 20 53 65 74 | 74 69 6e 67 20 63 6f 75 |   * Set|ting cou|
|00000da0| 6e 74 20 74 6f 20 30 20 | 61 6e 64 20 66 6f 6c 64 |nt to 0 |and fold|
|00000db0| 65 72 73 20 74 6f 20 6e | 69 6c 20 69 73 20 4f 4b |ers to n|il is OK|
|00000dc0| 2e 0d 20 20 20 2a 20 53 | 65 61 72 63 68 65 73 20 |..   * S|earches |
|00000dd0| 74 68 65 20 73 70 65 63 | 69 66 69 65 64 20 66 6f |the spec|ified fo|
|00000de0| 6c 64 65 72 73 20 61 6e | 64 20 74 68 65 6e 20 74 |lders an|d then t|
|00000df0| 68 65 20 50 72 65 66 65 | 72 65 6e 63 65 73 20 66 |he Prefe|rences f|
|00000e00| 6f 6c 64 65 72 0d 20 20 | 20 2a 20 69 6e 20 61 20 |older.  | * in a |
|00000e10| 75 6e 73 70 65 63 69 66 | 69 65 64 20 6d 61 6e 6e |unspecif|ied mann|
|00000e20| 65 72 2e 0d 20 20 20 2a | 2f 0d 0d 70 61 73 63 61 |er..   *|/..pasca|
|00000e30| 6c 20 49 43 45 72 72 6f | 72 20 49 43 43 46 69 6e |l ICErro|r ICCFin|
|00000e40| 64 55 73 65 72 43 6f 6e | 66 69 67 46 69 6c 65 28 |dUserCon|figFile(|
|00000e50| 69 6e 74 65 72 6e 65 74 | 43 6f 6e 66 69 67 75 72 |internet|Configur|
|00000e60| 61 74 69 6f 6e 43 6f 6d | 70 6f 6e 65 6e 74 20 69 |ationCom|ponent i|
|00000e70| 6e 73 74 2c 20 49 43 44 | 69 72 53 70 65 63 20 2a |nst, ICD|irSpec *|
|00000e80| 77 68 65 72 65 29 0d 46 | 49 56 45 57 4f 52 44 49 |where).F|IVEWORDI|
|00000e90| 4e 4c 49 4e 45 28 30 78 | 32 46 33 43 2c 20 34 2c |NLINE(0x|2F3C, 4,|
|00000ea0| 20 31 34 2c 20 30 78 37 | 30 30 30 2c 20 30 78 41 | 14, 0x7|000, 0xA|
|00000eb0| 38 32 41 29 3b 0d 20 20 | 2f 2a 20 52 65 71 75 69 |82A);.  |/* Requi|
|00000ec0| 72 65 73 20 49 43 20 31 | 2e 31 2e 0d 20 20 20 2a |res IC 1|.1..   *|
|00000ed0| 20 49 74 20 69 73 20 69 | 6c 6c 65 67 61 6c 20 74 | It is i|llegal t|
|00000ee0| 6f 20 63 61 6c 6c 20 74 | 68 69 73 20 72 6f 75 74 |o call t|his rout|
|00000ef0| 69 6e 65 20 69 6e 73 69 | 64 65 20 61 20 49 43 42 |ine insi|de a ICB|
|00000f00| 65 67 69 6e 2f 45 6e 64 | 20 70 61 69 72 2e 0d 20 |egin/End| pair.. |
|00000f10| 20 20 2a 20 53 69 6d 69 | 6c 61 72 20 74 6f 20 49 |  * Simi|lar to I|
|00000f20| 43 46 69 6e 64 43 6f 6e | 66 69 67 46 69 6c 65 20 |CFindCon|figFile |
|00000f30| 65 78 63 65 70 74 20 74 | 68 61 74 20 69 74 20 6f |except t|hat it o|
|00000f40| 6e 6c 79 20 73 65 61 72 | 63 68 65 73 20 74 68 65 |nly sear|ches the|
|00000f50| 20 66 6f 6c 64 65 72 0d | 20 20 20 2a 20 73 70 65 | folder.|   * spe|
|00000f60| 63 69 66 69 65 64 20 69 | 6e 20 77 68 65 72 65 2e |cified i|n where.|
|00000f70| 20 20 49 66 20 74 68 65 | 20 69 6e 70 75 74 20 70 |  If the| input p|
|00000f80| 61 72 61 6d 65 74 65 72 | 73 20 61 72 65 20 76 61 |arameter|s are va|
|00000f90| 6c 69 64 20 74 68 65 20 | 72 6f 75 74 69 6e 65 0d |lid the |routine.|
|00000fa0| 20 20 20 2a 20 77 69 6c | 6c 20 61 6c 77 61 79 73 |   * wil|l always|
|00000fb0| 20 73 75 63 63 65 73 73 | 66 75 6c 20 63 6f 6e 66 | success|ful conf|
|00000fc0| 69 67 75 72 65 20 74 68 | 65 20 69 6e 73 74 61 6e |igure th|e instan|
|00000fd0| 63 65 2c 20 63 72 65 61 | 74 69 6e 67 20 61 6e 0d |ce, crea|ting an.|
|00000fe0| 20 20 20 2a 20 65 6d 70 | 74 79 20 63 6f 6e 66 69 |   * emp|ty confi|
|00000ff0| 67 75 72 61 74 69 6f 6e | 20 69 66 20 6e 65 63 65 |guration| if nece|
|00001000| 73 73 61 72 79 0d 20 20 | 20 2a 20 46 6f 72 20 75 |ssary.  | * For u|
|00001010| 73 65 20 77 69 74 68 20 | 64 6f 75 62 6c 65 2d 63 |se with |double-c|
|00001020| 6c 69 63 6b 61 62 6c 65 | 20 70 72 65 66 65 72 65 |lickable| prefere|
|00001030| 6e 63 65 20 66 69 6c 65 | 73 2e 0d 20 20 20 2a 2f |nce file|s..   */|
|00001040| 0d 0d 70 61 73 63 61 6c | 20 49 43 45 72 72 6f 72 |..pascal| ICError|
|00001050| 20 49 43 43 47 65 6e 65 | 72 61 6c 46 69 6e 64 43 | ICCGene|ralFindC|
|00001060| 6f 6e 66 69 67 46 69 6c | 65 28 69 6e 74 65 72 6e |onfigFil|e(intern|
|00001070| 65 74 43 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 43 |etConfig|urationC|
|00001080| 6f 6d 70 6f 6e 65 6e 74 | 20 69 6e 73 74 2c 20 42 |omponent| inst, B|
|00001090| 6f 6f 6c 65 61 6e 20 73 | 65 61 72 63 68 5f 70 72 |oolean s|earch_pr|
|000010a0| 65 66 73 2c 20 42 6f 6f | 6c 65 61 6e 20 63 61 6e |efs, Boo|lean can|
|000010b0| 5f 63 72 65 61 74 65 2c | 20 73 68 6f 72 74 20 63 |_create,| short c|
|000010c0| 6f 75 6e 74 2c 20 49 43 | 44 69 72 53 70 65 63 41 |ount, IC|DirSpecA|
|000010d0| 72 72 61 79 50 74 72 20 | 66 6f 6c 64 65 72 73 29 |rrayPtr |folders)|
|000010e0| 0d 46 49 56 45 57 4f 52 | 44 49 4e 4c 49 4e 45 28 |.FIVEWOR|DINLINE(|
|000010f0| 30 78 32 46 33 43 2c 20 | 31 30 2c 20 33 30 2c 20 |0x2F3C, |10, 30, |
|00001100| 30 78 37 30 30 30 2c 20 | 30 78 41 38 32 41 29 3b |0x7000, |0xA82A);|
|00001110| 0d 20 20 2f 2a 20 52 65 | 71 75 69 72 65 73 20 49 |.  /* Re|quires I|
|00001120| 43 20 31 2e 32 2e 0d 20 | 20 20 2a 20 49 74 20 69 |C 1.2.. |  * It i|
|00001130| 73 20 69 6c 6c 65 67 61 | 6c 20 74 6f 20 63 61 6c |s illega|l to cal|
|00001140| 6c 20 74 68 69 73 20 72 | 6f 75 74 69 6e 65 20 69 |l this r|outine i|
|00001150| 6e 73 69 64 65 20 61 20 | 49 43 42 65 67 69 6e 2f |nside a |ICBegin/|
|00001160| 45 6e 64 20 70 61 69 72 | 2e 0d 20 20 20 2a 20 43 |End pair|..   * C|
|00001170| 61 6c 6c 20 74 6f 20 63 | 6f 6e 66 69 67 75 72 65 |all to c|onfigure|
|00001180| 20 74 68 69 73 20 63 6f | 6e 6e 65 63 74 69 6f 6e | this co|nnection|
|00001190| 20 74 6f 20 49 43 2e 0d | 20 20 20 2a 20 54 68 69 | to IC..|   * Thi|
|000011a0| 73 20 72 6f 75 74 69 6e | 65 20 61 63 74 73 20 61 |s routin|e acts a|
|000011b0| 73 20 61 20 6d 6f 72 65 | 20 67 65 6e 65 72 61 6c |s a more| general|
|000011c0| 20 72 65 70 6c 61 63 65 | 6d 65 6e 74 20 66 6f 72 | replace|ment for|
|000011d0| 0d 20 20 20 2a 20 49 43 | 46 69 6e 64 43 6f 6e 66 |.   * IC|FindConf|
|000011e0| 69 67 46 69 6c 65 20 61 | 6e 64 20 49 43 46 69 6e |igFile a|nd ICFin|
|000011f0| 64 55 73 65 72 43 6f 6e | 66 69 67 46 69 6c 65 2e |dUserCon|figFile.|
|00001200| 0d 20 20 20 2a 20 53 65 | 74 20 73 65 61 72 63 68 |.   * Se|t search|
|00001210| 5f 70 72 65 66 73 20 74 | 6f 20 74 72 75 65 20 69 |_prefs t|o true i|
|00001220| 66 20 79 6f 75 20 77 61 | 6e 74 20 69 74 20 74 6f |f you wa|nt it to|
|00001230| 20 73 65 61 72 63 68 20 | 74 68 65 20 70 72 65 66 | search |the pref|
|00001240| 65 72 65 6e 63 65 73 20 | 66 6f 6c 64 65 72 2e 0d |erences |folder..|
|00001250| 20 20 20 2a 20 53 65 74 | 20 63 61 6e 5f 63 72 65 |   * Set| can_cre|
|00001260| 61 74 65 20 74 6f 20 74 | 72 75 65 20 69 66 20 79 |ate to t|rue if y|
|00001270| 6f 75 20 77 61 6e 74 20 | 69 74 20 74 6f 20 62 65 |ou want |it to be|
|00001280| 20 61 62 6c 65 20 74 6f | 20 63 72 65 61 74 65 20 | able to| create |
|00001290| 61 20 6e 65 77 20 63 6f | 6e 66 69 67 2e 0d 20 20 |a new co|nfig..  |
|000012a0| 20 2a 20 53 65 74 20 63 | 6f 75 6e 74 20 61 73 20 | * Set c|ount as |
|000012b0| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 76 61 |the numb|er of va|
|000012c0| 6c 69 64 20 65 6c 65 6d | 65 6e 74 73 20 69 6e 20 |lid elem|ents in |
|000012d0| 66 6f 6c 64 65 72 73 2e | 0d 20 20 20 2a 20 53 65 |folders.|.   * Se|
|000012e0| 74 20 66 6f 6c 64 65 72 | 73 20 74 6f 20 61 20 70 |t folder|s to a p|
|000012f0| 6f 69 6e 74 65 72 20 74 | 6f 20 74 68 65 20 66 6f |ointer t|o the fo|
|00001300| 6c 64 65 72 73 20 74 6f | 20 73 65 61 72 63 68 2e |lders to| search.|
|00001310| 0d 20 20 20 2a 20 53 65 | 74 74 69 6e 67 20 63 6f |.   * Se|tting co|
|00001320| 75 6e 74 20 74 6f 20 30 | 20 61 6e 64 20 66 6f 6c |unt to 0| and fol|
|00001330| 64 65 72 73 20 74 6f 20 | 6e 69 6c 20 69 73 20 4f |ders to |nil is O|
|00001340| 4b 2e 0d 20 20 20 2a 20 | 53 65 61 72 63 68 65 73 |K..   * |Searches|
|00001350| 20 74 68 65 20 73 70 65 | 63 69 66 69 65 64 20 66 | the spe|cified f|
|00001360| 6f 6c 64 65 72 73 20 61 | 6e 64 20 74 68 65 6e 20 |olders a|nd then |
|00001370| 6f 70 74 69 6f 6e 61 6c | 6c 79 20 74 68 65 20 50 |optional|ly the P|
|00001380| 72 65 66 65 72 65 6e 63 | 65 73 20 66 6f 6c 64 65 |referenc|es folde|
|00001390| 72 0d 20 20 20 2a 20 69 | 6e 20 61 20 75 6e 73 70 |r.   * i|n a unsp|
|000013a0| 65 63 69 66 69 65 64 20 | 6d 61 6e 6e 65 72 2e 0d |ecified |manner..|
|000013b0| 20 20 20 2a 2f 0d 0d 70 | 61 73 63 61 6c 20 49 43 |   */..p|ascal IC|
|000013c0| 45 72 72 6f 72 20 49 43 | 43 43 68 6f 6f 73 65 43 |Error IC|CChooseC|
|000013d0| 6f 6e 66 69 67 28 69 6e | 74 65 72 6e 65 74 43 6f |onfig(in|ternetCo|
|000013e0| 6e 66 69 67 75 72 61 74 | 69 6f 6e 43 6f 6d 70 6f |nfigurat|ionCompo|
|000013f0| 6e 65 6e 74 20 69 6e 73 | 74 29 0d 46 49 56 45 57 |nent ins|t).FIVEW|
|00001400| 4f 52 44 49 4e 4c 49 4e | 45 28 30 78 32 46 33 43 |ORDINLIN|E(0x2F3C|
|00001410| 2c 20 30 2c 20 33 33 2c | 20 30 78 37 30 30 30 2c |, 0, 33,| 0x7000,|
|00001420| 20 30 78 41 38 32 41 29 | 3b 0d 20 20 2f 2a 20 52 | 0xA82A)|;.  /* R|
|00001430| 65 71 75 69 72 65 73 20 | 49 43 20 31 2e 32 2e 0d |equires |IC 1.2..|
|00001440| 20 20 20 2a 20 49 74 20 | 69 73 20 69 6c 6c 65 67 |   * It |is illeg|
|00001450| 61 6c 20 74 6f 20 63 61 | 6c 6c 20 74 68 69 73 20 |al to ca|ll this |
|00001460| 72 6f 75 74 69 6e 65 20 | 69 6e 73 69 64 65 20 61 |routine |inside a|
|00001470| 20 49 43 42 65 67 69 6e | 2f 45 6e 64 20 70 61 69 | ICBegin|/End pai|
|00001480| 72 2e 0d 20 20 20 2a 20 | 52 65 71 75 65 73 74 73 |r..   * |Requests|
|00001490| 20 74 68 65 20 75 73 65 | 72 20 74 6f 20 63 68 6f | the use|r to cho|
|000014a0| 6f 73 65 20 61 20 63 6f | 6e 66 69 67 75 72 61 74 |ose a co|nfigurat|
|000014b0| 69 6f 6e 2c 20 74 79 70 | 69 63 61 6c 6c 79 20 75 |ion, typ|ically u|
|000014c0| 73 69 6e 67 20 73 6f 6d | 65 0d 20 20 20 2a 20 73 |sing som|e.   * s|
|000014d0| 6f 72 74 20 6f 66 20 6d | 6f 64 61 6c 20 64 69 61 |ort of m|odal dia|
|000014e0| 6c 6f 67 2e 20 49 66 20 | 74 68 65 20 75 73 65 72 |log. If |the user|
|000014f0| 20 63 61 6e 63 65 6c 73 | 20 74 68 65 20 64 69 61 | cancels| the dia|
|00001500| 6c 6f 67 20 74 68 65 20 | 63 6f 6e 66 69 67 75 72 |log the |configur|
|00001510| 61 74 69 6f 6e 0d 20 20 | 20 2a 20 73 74 61 74 65 |ation.  | * state|
|00001520| 20 77 69 6c 6c 20 62 65 | 20 75 6e 61 66 66 65 63 | will be| unaffec|
|00001530| 74 65 64 2e 0d 20 20 20 | 2a 2f 0d 0d 70 61 73 63 |ted..   |*/..pasc|
|00001540| 61 6c 20 49 43 45 72 72 | 6f 72 20 49 43 43 43 68 |al ICErr|or ICCCh|
|00001550| 6f 6f 73 65 4e 65 77 43 | 6f 6e 66 69 67 28 69 6e |ooseNewC|onfig(in|
|00001560| 74 65 72 6e 65 74 43 6f | 6e 66 69 67 75 72 61 74 |ternetCo|nfigurat|
|00001570| 69 6f 6e 43 6f 6d 70 6f | 6e 65 6e 74 20 69 6e 73 |ionCompo|nent ins|
|00001580| 74 29 0d 46 49 56 45 57 | 4f 52 44 49 4e 4c 49 4e |t).FIVEW|ORDINLIN|
|00001590| 45 28 30 78 32 46 33 43 | 2c 20 30 2c 20 33 34 2c |E(0x2F3C|, 0, 34,|
|000015a0| 20 30 78 37 30 30 30 2c | 20 30 78 41 38 32 41 29 | 0x7000,| 0xA82A)|
|000015b0| 3b 0d 20 20 2f 2a 20 52 | 65 71 75 69 72 65 73 20 |;.  /* R|equires |
|000015c0| 49 43 20 31 2e 32 2e 0d | 20 20 20 2a 20 49 74 20 |IC 1.2..|   * It |
|000015d0| 69 73 20 69 6c 6c 65 67 | 61 6c 20 74 6f 20 63 61 |is illeg|al to ca|
|000015e0| 6c 6c 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 20 |ll this |routine |
|000015f0| 69 6e 73 69 64 65 20 61 | 20 49 43 42 65 67 69 6e |inside a| ICBegin|
|00001600| 2f 45 6e 64 20 70 61 69 | 72 2e 0d 20 20 20 2a 20 |/End pai|r..   * |
|00001610| 52 65 71 75 65 73 74 73 | 20 74 68 65 20 75 73 65 |Requests| the use|
|00001620| 72 20 74 6f 20 63 72 65 | 61 74 65 20 61 20 6e 65 |r to cre|ate a ne|
|00001630| 77 20 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 2c |w config|uration,|
|00001640| 20 74 79 70 69 63 61 6c | 6c 79 20 75 73 69 6e 67 | typical|ly using|
|00001650| 20 73 6f 6d 65 0d 20 20 | 20 2a 20 73 6f 72 74 20 | some.  | * sort |
|00001660| 6f 66 20 6d 6f 64 61 6c | 20 64 69 61 6c 6f 67 2e |of modal| dialog.|
|00001670| 20 49 66 20 74 68 65 20 | 75 73 65 72 20 63 61 6e | If the |user can|
|00001680| 63 65 6c 73 20 74 68 65 | 20 64 69 61 6c 6f 67 20 |cels the| dialog |
|00001690| 74 68 65 20 63 6f 6e 66 | 69 67 75 72 61 74 69 6f |the conf|iguratio|
|000016a0| 6e 0d 20 20 20 2a 20 73 | 74 61 74 65 20 77 69 6c |n.   * s|tate wil|
|000016b0| 6c 20 62 65 20 75 6e 61 | 66 66 65 63 74 65 64 2e |l be una|ffected.|
|000016c0| 0d 20 20 20 2a 2f 0d 0d | 70 61 73 63 61 6c 20 49 |.   */..|pascal I|
|000016d0| 43 45 72 72 6f 72 20 49 | 43 43 47 65 74 43 6f 6e |CError I|CCGetCon|
|000016e0| 66 69 67 4e 61 6d 65 28 | 69 6e 74 65 72 6e 65 74 |figName(|internet|
|000016f0| 43 6f 6e 66 69 67 75 72 | 61 74 69 6f 6e 43 6f 6d |Configur|ationCom|
|00001700| 70 6f 6e 65 6e 74 20 69 | 6e 73 74 2c 20 42 6f 6f |ponent i|nst, Boo|
|00001710| 6c 65 61 6e 20 6c 6f 6e | 67 6e 61 6d 65 2c 20 53 |lean lon|gname, S|
|00001720| 74 72 32 35 35 20 6e 61 | 6d 65 29 0d 46 49 56 45 |tr255 na|me).FIVE|
|00001730| 57 4f 52 44 49 4e 4c 49 | 4e 45 28 30 78 32 46 33 |WORDINLI|NE(0x2F3|
|00001740| 43 2c 20 36 2c 20 33 35 | 2c 20 30 78 37 30 30 30 |C, 6, 35|, 0x7000|
|00001750| 2c 20 30 78 41 38 32 41 | 29 3b 0d 20 20 2f 2a 20 |, 0xA82A|);.  /* |
|00001760| 52 65 71 75 69 72 65 73 | 20 49 43 20 31 2e 32 2e |Requires| IC 1.2.|
|00001770| 0d 20 20 20 2a 20 59 6f | 75 20 6d 75 73 74 20 73 |.   * Yo|u must s|
|00001780| 70 65 63 69 66 79 20 61 | 20 63 6f 6e 66 69 67 75 |pecify a| configu|
|00001790| 72 61 74 69 6f 6e 20 62 | 65 66 6f 72 65 20 63 61 |ration b|efore ca|
|000017a0| 6c 6c 69 6e 67 20 74 68 | 69 73 20 72 6f 75 74 69 |lling th|is routi|
|000017b0| 6e 65 2e 0d 20 20 20 2a | 20 52 65 74 75 72 6e 73 |ne..   *| Returns|
|000017c0| 20 61 20 73 74 72 69 6e | 67 20 74 68 61 74 20 64 | a strin|g that d|
|000017d0| 65 73 63 72 69 62 65 73 | 20 74 68 65 20 63 75 72 |escribes| the cur|
|000017e0| 72 65 6e 74 20 63 6f 6e | 66 69 67 75 72 61 74 69 |rent con|figurati|
|000017f0| 6f 6e 20 61 74 20 61 20 | 75 73 65 72 0d 20 20 20 |on at a |user.   |
|00001800| 2a 20 6c 65 76 65 6c 2e | 20 53 65 74 20 6c 6f 6e |* level.| Set lon|
|00001810| 67 6e 61 6d 65 20 74 6f | 20 74 72 75 65 20 69 66 |gname to| true if|
|00001820| 20 79 6f 75 20 77 61 6e | 74 20 61 20 6c 6f 6e 67 | you wan|t a long|
|00001830| 20 6e 61 6d 65 2c 20 75 | 70 20 74 6f 20 32 35 35 | name, u|p to 255|
|00001840| 0d 20 20 20 2a 20 63 68 | 61 72 61 63 74 65 72 73 |.   * ch|aracters|
|00001850| 2c 20 6f 72 20 66 61 6c | 73 65 20 69 66 20 79 6f |, or fal|se if yo|
|00001860| 75 20 77 61 6e 74 20 61 | 20 73 68 6f 72 74 20 6e |u want a| short n|
|00001870| 61 6d 65 2c 20 74 79 70 | 69 63 61 6c 6c 79 20 61 |ame, typ|ically a|
|00001880| 62 6f 75 74 20 33 32 0d | 20 20 20 2a 20 63 68 61 |bout 32.|   * cha|
|00001890| 72 61 63 74 65 72 73 2e | 0d 20 20 20 2a 20 54 68 |racters.|.   * Th|
|000018a0| 65 20 72 65 74 75 72 6e | 65 64 20 73 74 72 69 6e |e return|ed strin|
|000018b0| 67 20 69 73 20 66 6f 72 | 20 75 73 65 72 20 64 69 |g is for| user di|
|000018c0| 73 70 6c 61 79 20 6f 6e | 6c 79 2e 20 49 66 20 79 |splay on|ly. If y|
|000018d0| 6f 75 20 72 65 6c 79 20 | 6f 6e 20 74 68 65 0d 20 |ou rely |on the. |
|000018e0| 20 20 2a 20 65 78 61 63 | 74 20 66 6f 72 6d 61 74 |  * exac|t format|
|000018f0| 20 6f 66 20 69 74 2c 20 | 79 6f 75 20 77 69 6c 6c | of it, |you will|
|00001900| 20 63 6f 6e 66 6c 69 63 | 74 20 77 69 74 68 20 61 | conflic|t with a|
|00001910| 6e 79 20 66 75 74 75 72 | 65 20 49 43 0d 20 20 20 |ny futur|e IC.   |
|00001920| 2a 20 69 6d 70 6c 65 6d | 65 6e 74 61 74 69 6f 6e |* implem|entation|
|00001930| 20 74 68 61 74 20 64 6f | 65 73 6e 27 74 20 75 73 | that do|esn't us|
|00001940| 65 20 65 78 70 6c 69 63 | 69 74 20 70 72 65 66 65 |e explic|it prefe|
|00001950| 72 65 6e 63 65 20 66 69 | 6c 65 73 2e 0d 20 20 20 |rence fi|les..   |
|00001960| 2a 2f 0d 0d 70 61 73 63 | 61 6c 20 49 43 45 72 72 |*/..pasc|al ICErr|
|00001970| 6f 72 20 49 43 43 47 65 | 74 43 6f 6e 66 69 67 52 |or ICCGe|tConfigR|
|00001980| 65 66 65 72 65 6e 63 65 | 28 69 6e 74 65 72 6e 65 |eference|(interne|
|00001990| 74 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 43 6f |tConfigu|rationCo|
|000019a0| 6d 70 6f 6e 65 6e 74 20 | 69 6e 73 74 2c 20 49 43 |mponent |inst, IC|
|000019b0| 43 6f 6e 66 69 67 52 65 | 66 48 61 6e 64 6c 65 20 |ConfigRe|fHandle |
|000019c0| 72 65 66 29 0d 46 49 56 | 45 57 4f 52 44 49 4e 4c |ref).FIV|EWORDINL|
|000019d0| 49 4e 45 28 30 78 32 46 | 33 43 2c 20 34 2c 20 33 |INE(0x2F|3C, 4, 3|
|000019e0| 31 2c 20 30 78 37 30 30 | 30 2c 20 30 78 41 38 32 |1, 0x700|0, 0xA82|
|000019f0| 41 29 3b 0d 20 20 2f 2a | 20 52 65 71 75 69 72 65 |A);.  /*| Require|
|00001a00| 73 20 49 43 20 31 2e 32 | 2e 0d 20 20 20 2a 20 59 |s IC 1.2|..   * Y|
|00001a10| 6f 75 20 6d 75 73 74 20 | 73 70 65 63 69 66 79 20 |ou must |specify |
|00001a20| 61 20 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 20 |a config|uration |
|00001a30| 62 65 66 6f 72 65 20 63 | 61 6c 6c 69 6e 67 20 74 |before c|alling t|
|00001a40| 68 69 73 20 72 6f 75 74 | 69 6e 65 2e 0d 20 20 20 |his rout|ine..   |
|00001a50| 2a 20 52 65 74 75 72 6e | 73 20 61 20 73 65 6c 66 |* Return|s a self|
|00001a60| 2d 63 6f 6e 74 61 69 6e | 65 64 20 72 65 66 65 72 |-contain|ed refer|
|00001a70| 65 6e 63 65 20 74 6f 20 | 74 68 65 20 69 6e 73 74 |ence to |the inst|
|00001a80| 61 6e 63 65 27 73 20 63 | 75 72 72 65 6e 74 0d 20 |ance's c|urrent. |
|00001a90| 20 20 2a 20 63 6f 6e 66 | 69 67 75 72 61 74 69 6f |  * conf|iguratio|
|00001aa0| 6e 2e 0d 20 20 20 2a 20 | 72 65 66 20 6d 75 73 74 |n..   * |ref must|
|00001ab0| 20 62 65 20 61 20 76 61 | 6c 69 64 20 6e 6f 6e 2d | be a va|lid non-|
|00001ac0| 6e 69 6c 20 68 61 6e 64 | 6c 65 20 61 6e 64 20 69 |nil hand|le and i|
|00001ad0| 74 20 77 69 6c 6c 20 62 | 65 20 72 65 73 69 7a 65 |t will b|e resize|
|00001ae0| 64 20 74 6f 20 66 69 74 | 20 74 68 65 0d 20 20 20 |d to fit| the.   |
|00001af0| 2a 20 72 65 73 75 6c 74 | 69 6e 67 20 64 61 74 61 |* result|ing data|
|00001b00| 2e 0d 20 20 20 2a 2f 0d | 0d 70 61 73 63 61 6c 20 |..   */.|.pascal |
|00001b10| 49 43 45 72 72 6f 72 20 | 49 43 43 53 65 74 43 6f |ICError |ICCSetCo|
|00001b20| 6e 66 69 67 52 65 66 65 | 72 65 6e 63 65 28 69 6e |nfigRefe|rence(in|
|00001b30| 74 65 72 6e 65 74 43 6f | 6e 66 69 67 75 72 61 74 |ternetCo|nfigurat|
|00001b40| 69 6f 6e 43 6f 6d 70 6f | 6e 65 6e 74 20 69 6e 73 |ionCompo|nent ins|
|00001b50| 74 2c 20 49 43 43 6f 6e | 66 69 67 52 65 66 48 61 |t, ICCon|figRefHa|
|00001b60| 6e 64 6c 65 20 72 65 66 | 2c 20 6c 6f 6e 67 20 66 |ndle ref|, long f|
|00001b70| 6c 61 67 73 29 0d 46 49 | 56 45 57 4f 52 44 49 4e |lags).FI|VEWORDIN|
|00001b80| 4c 49 4e 45 28 30 78 32 | 46 33 43 2c 20 38 2c 20 |LINE(0x2|F3C, 8, |
|00001b90| 33 32 2c 20 30 78 37 30 | 30 30 2c 20 30 78 41 38 |32, 0x70|00, 0xA8|
|00001ba0| 32 41 29 3b 0d 20 20 2f | 2a 20 52 65 71 75 69 72 |2A);.  /|* Requir|
|00001bb0| 65 73 20 49 43 20 31 2e | 32 2e 0d 20 20 20 2a 20 |es IC 1.|2..   * |
|00001bc0| 49 74 20 69 73 20 69 6c | 6c 65 67 61 6c 20 74 6f |It is il|legal to|
|00001bd0| 20 63 61 6c 6c 20 74 68 | 69 73 20 72 6f 75 74 69 | call th|is routi|
|00001be0| 6e 65 20 69 6e 73 69 64 | 65 20 61 20 49 43 42 65 |ne insid|e a ICBe|
|00001bf0| 67 69 6e 2f 45 6e 64 20 | 70 61 69 72 2e 0d 20 20 |gin/End |pair..  |
|00001c00| 20 2a 20 52 65 63 6f 6e | 66 69 67 75 72 65 73 20 | * Recon|figures |
|00001c10| 74 68 65 20 69 6e 73 74 | 61 6e 63 65 20 75 73 69 |the inst|ance usi|
|00001c20| 6e 67 20 61 20 63 6f 6e | 66 69 67 75 72 61 74 69 |ng a con|figurati|
|00001c30| 6f 6e 20 72 65 66 65 72 | 65 6e 63 65 20 74 68 61 |on refer|ence tha|
|00001c40| 74 20 77 61 73 0d 20 20 | 20 2a 20 67 6f 74 20 75 |t was.  | * got u|
|00001c50| 73 69 6e 67 20 49 43 47 | 65 74 43 6f 6e 66 69 67 |sing ICG|etConfig|
|00001c60| 52 65 66 65 72 65 6e 63 | 65 20 72 65 66 65 72 65 |Referenc|e refere|
|00001c70| 6e 63 65 2e 20 53 65 74 | 20 74 68 65 0d 20 20 20 |nce. Set| the.   |
|00001c80| 2a 20 69 63 4e 6f 55 73 | 65 72 49 6e 74 65 72 61 |* icNoUs|erIntera|
|00001c90| 63 74 69 6f 6e 5f 62 69 | 74 20 69 6e 20 66 6c 61 |ction_bi|t in fla|
|00001ca0| 67 73 20 69 66 20 79 6f | 75 20 72 65 71 75 69 72 |gs if yo|u requir|
|00001cb0| 65 20 74 68 61 74 20 74 | 68 69 73 20 72 6f 75 74 |e that t|his rout|
|00001cc0| 69 6e 65 0d 20 20 20 2a | 20 6e 6f 74 20 70 72 65 |ine.   *| not pre|
|00001cd0| 73 65 6e 74 20 61 20 6d | 6f 64 61 6c 20 64 69 61 |sent a m|odal dia|
|00001ce0| 6c 6f 67 2e 20 4f 74 68 | 65 72 20 66 6c 61 67 20 |log. Oth|er flag |
|00001cf0| 62 69 74 73 20 61 72 65 | 20 72 65 73 65 72 76 65 |bits are| reserve|
|00001d00| 64 20 61 6e 64 20 73 68 | 6f 75 6c 64 0d 20 20 20 |d and sh|ould.   |
|00001d10| 2a 20 62 65 20 73 65 74 | 20 74 6f 20 7a 65 72 6f |* be set| to zero|
|00001d20| 2e 0d 20 20 20 2a 20 72 | 65 66 20 6d 75 73 74 20 |..   * r|ef must |
|00001d30| 6e 6f 74 20 62 65 20 6e | 69 6c 2e 0d 20 20 20 2a |not be n|il..   *|
|00001d40| 2f 0d 0d 70 61 73 63 61 | 6c 20 49 43 45 72 72 6f |/..pasca|l ICErro|
|00001d50| 72 20 49 43 43 53 70 65 | 63 69 66 79 43 6f 6e 66 |r ICCSpe|cifyConf|
|00001d60| 69 67 46 69 6c 65 28 69 | 6e 74 65 72 6e 65 74 43 |igFile(i|nternetC|
|00001d70| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 43 6f 6d 70 |onfigura|tionComp|
|00001d80| 6f 6e 65 6e 74 20 69 6e | 73 74 2c 20 46 53 53 70 |onent in|st, FSSp|
|00001d90| 65 63 20 2a 63 6f 6e 66 | 69 67 29 0d 46 49 56 45 |ec *conf|ig).FIVE|
|00001da0| 57 4f 52 44 49 4e 4c 49 | 4e 45 28 30 78 32 46 33 |WORDINLI|NE(0x2F3|
|00001db0| 43 2c 20 34 2c 20 33 2c | 20 30 78 37 30 30 30 2c |C, 4, 3,| 0x7000,|
|00001dc0| 20 30 78 41 38 32 41 29 | 3b 0d 20 20 2f 2a 20 49 | 0xA82A)|;.  /* I|
|00001dd0| 74 20 69 73 20 69 6c 6c | 65 67 61 6c 20 74 6f 20 |t is ill|egal to |
|00001de0| 63 61 6c 6c 20 74 68 69 | 73 20 72 6f 75 74 69 6e |call thi|s routin|
|00001df0| 65 20 69 6e 73 69 64 65 | 20 61 20 49 43 42 65 67 |e inside| a ICBeg|
|00001e00| 69 6e 2f 45 6e 64 20 70 | 61 69 72 2e 0d 20 20 20 |in/End p|air..   |
|00001e10| 2a 20 46 6f 72 20 75 73 | 65 20 6f 6e 6c 79 20 62 |* For us|e only b|
|00001e20| 79 20 74 68 65 20 49 43 | 20 61 70 70 6c 69 63 61 |y the IC| applica|
|00001e30| 74 69 6f 6e 2e 0d 20 20 | 20 2a 20 49 66 20 79 6f |tion..  | * If yo|
|00001e40| 75 20 63 61 6c 6c 20 74 | 68 69 73 20 72 6f 75 74 |u call t|his rout|
|00001e50| 69 6e 65 20 79 6f 75 72 | 73 65 6c 66 2c 20 79 6f |ine your|self, yo|
|00001e60| 75 20 77 69 6c 6c 20 63 | 6f 6e 66 6c 69 63 74 20 |u will c|onflict |
|00001e70| 77 69 74 68 20 61 6e 79 | 0d 20 20 20 2a 20 66 75 |with any|.   * fu|
|00001e80| 74 75 72 65 20 49 43 20 | 69 6d 70 6c 65 6d 65 6e |ture IC |implemen|
|00001e90| 74 61 74 69 6f 6e 20 74 | 68 61 74 20 64 6f 65 73 |tation t|hat does|
|00001ea0| 6e 27 74 20 75 73 65 20 | 65 78 70 6c 69 63 69 74 |n't use |explicit|
|00001eb0| 20 70 72 65 66 65 72 65 | 6e 63 65 20 66 69 6c 65 | prefere|nce file|
|00001ec0| 73 2e 0d 20 20 20 2a 2f | 0d 0d 2f 2a 20 2a 2a 2a |s..   */|../* ***|
|00001ed0| 2a 2a 20 47 65 74 74 69 | 6e 67 20 49 6e 66 6f 72 |** Getti|ng Infor|
|00001ee0| 6d 61 74 69 6f 6e 20 2a | 2a 2a 2a 2a 20 2a 2f 0d |mation *|**** */.|
|00001ef0| 0d 70 61 73 63 61 6c 20 | 49 43 45 72 72 6f 72 20 |.pascal |ICError |
|00001f00| 49 43 43 47 65 74 53 65 | 65 64 28 69 6e 74 65 72 |ICCGetSe|ed(inter|
|00001f10| 6e 65 74 43 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e |netConfi|guration|
|00001f20| 43 6f 6d 70 6f 6e 65 6e | 74 20 69 6e 73 74 2c 20 |Componen|t inst, |
|00001f30| 6c 6f 6e 67 20 2a 73 65 | 65 64 29 0d 46 49 56 45 |long *se|ed).FIVE|
|00001f40| 57 4f 52 44 49 4e 4c 49 | 4e 45 28 30 78 32 46 33 |WORDINLI|NE(0x2F3|
|00001f50| 43 2c 20 34 2c 20 34 2c | 20 30 78 37 30 30 30 2c |C, 4, 4,| 0x7000,|
|00001f60| 20 30 78 41 38 32 41 29 | 3b 0d 20 20 2f 2a 20 59 | 0xA82A)|;.  /* Y|
|00001f70| 6f 75 20 64 6f 20 6e 6f | 74 20 68 61 76 65 20 74 |ou do no|t have t|
|00001f80| 6f 20 73 70 65 63 69 66 | 79 20 61 20 63 6f 6e 66 |o specif|y a conf|
|00001f90| 69 67 75 72 61 74 69 6f | 6e 20 62 65 66 6f 72 65 |iguratio|n before|
|00001fa0| 20 63 61 6c 6c 69 6e 67 | 20 74 68 69 73 20 72 6f | calling| this ro|
|00001fb0| 75 74 69 6e 65 2e 0d 20 | 20 20 2a 20 59 6f 75 20 |utine.. |  * You |
|00001fc0| 64 6f 20 6e 6f 74 20 68 | 61 76 65 20 74 6f 20 62 |do not h|ave to b|
|00001fd0| 65 20 69 6e 73 69 64 65 | 20 61 6e 20 49 43 42 65 |e inside| an ICBe|
|00001fe0| 67 69 6e 2f 45 6e 64 20 | 70 61 69 72 20 74 6f 20 |gin/End |pair to |
|00001ff0| 63 61 6c 6c 20 74 68 69 | 73 20 72 6f 75 74 69 6e |call thi|s routin|
|00002000| 65 2e 0d 20 20 20 2a 20 | 52 65 74 75 72 6e 73 20 |e..   * |Returns |
|00002010| 74 68 65 20 63 75 72 72 | 65 6e 74 20 73 65 65 64 |the curr|ent seed|
|00002020| 20 66 6f 72 20 74 68 65 | 20 49 43 20 70 72 65 66 | for the| IC pref|
|00002030| 73 20 64 61 74 61 62 61 | 73 65 2e 0d 20 20 20 2a |s databa|se..   *|
|00002040| 20 54 68 69 73 20 73 65 | 65 64 20 63 68 61 6e 67 | This se|ed chang|
|00002050| 65 73 20 65 61 63 68 20 | 74 69 6d 65 20 61 20 6e |es each |time a n|
|00002060| 6f 6e 2d 76 6f 6c 61 74 | 69 6c 65 20 70 72 65 66 |on-volat|ile pref|
|00002070| 65 72 65 6e 63 65 20 69 | 73 20 63 68 61 6e 67 65 |erence i|s change|
|00002080| 64 2e 0d 20 20 20 2a 20 | 59 6f 75 20 63 61 6e 20 |d..   * |You can |
|00002090| 70 6f 6c 6c 20 74 68 69 | 73 20 74 6f 20 64 65 74 |poll thi|s to det|
|000020a0| 65 72 6d 69 6e 65 20 69 | 66 20 61 6e 79 20 63 61 |ermine i|f any ca|
|000020b0| 63 68 65 64 20 70 72 65 | 66 65 72 65 6e 63 65 73 |ched pre|ferences|
|000020c0| 20 63 68 61 6e 67 65 2e | 0d 20 20 20 2a 2f 0d 0d | change.|.   */..|
|000020d0| 70 61 73 63 61 6c 20 49 | 43 45 72 72 6f 72 20 49 |pascal I|CError I|
|000020e0| 43 43 47 65 74 50 65 72 | 6d 28 69 6e 74 65 72 6e |CCGetPer|m(intern|
|000020f0| 65 74 43 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 43 |etConfig|urationC|
|00002100| 6f 6d 70 6f 6e 65 6e 74 | 20 69 6e 73 74 2c 20 49 |omponent| inst, I|
|00002110| 43 50 65 72 6d 20 2a 70 | 65 72 6d 29 0d 46 49 56 |CPerm *p|erm).FIV|
|00002120| 45 57 4f 52 44 49 4e 4c | 49 4e 45 28 30 78 32 46 |EWORDINL|INE(0x2F|
|00002130| 33 43 2c 20 34 2c 20 31 | 33 2c 20 30 78 37 30 30 |3C, 4, 1|3, 0x700|
|00002140| 30 2c 20 30 78 41 38 32 | 41 29 3b 0d 20 20 2f 2a |0, 0xA82|A);.  /*|
|00002150| 20 59 6f 75 20 64 6f 20 | 6e 6f 74 20 68 61 76 65 | You do |not have|
|00002160| 20 74 6f 20 73 70 65 63 | 69 66 79 20 61 20 63 6f | to spec|ify a co|
|00002170| 6e 66 69 67 75 72 61 74 | 69 6f 6e 20 62 65 66 6f |nfigurat|ion befo|
|00002180| 72 65 20 63 61 6c 6c 69 | 6e 67 20 74 68 69 73 20 |re calli|ng this |
|00002190| 72 6f 75 74 69 6e 65 2e | 0d 20 20 20 2a 20 52 65 |routine.|.   * Re|
|000021a0| 74 75 72 6e 73 20 74 68 | 65 20 61 63 63 65 73 73 |turns th|e access|
|000021b0| 20 70 65 72 6d 69 73 73 | 69 6f 6e 73 20 63 75 72 | permiss|ions cur|
|000021c0| 72 65 6e 74 6c 79 20 61 | 73 73 6f 63 69 61 74 65 |rently a|ssociate|
|000021d0| 64 20 77 69 74 68 20 74 | 68 69 73 20 69 6e 73 74 |d with t|his inst|
|000021e0| 61 6e 63 65 2e 0d 20 20 | 20 2a 20 57 68 69 6c 65 |ance..  | * While|
|000021f0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 73 20 6e 6f | applica|tions no|
|00002200| 72 6d 61 6c 6c 79 20 6b | 6e 6f 77 20 77 68 61 74 |rmally k|now what|
|00002210| 20 70 65 72 6d 69 73 73 | 69 6f 6e 73 20 74 68 65 | permiss|ions the|
|00002220| 79 20 68 61 76 65 2c 0d | 20 20 20 2a 20 74 68 69 |y have,.|   * thi|
|00002230| 73 20 72 6f 75 74 69 6e | 65 20 69 73 20 64 65 73 |s routin|e is des|
|00002240| 69 67 6e 65 64 20 66 6f | 72 20 75 73 65 20 62 79 |igned fo|r use by|
|00002250| 20 6f 76 65 72 72 69 64 | 65 20 63 6f 6d 70 6f 6e | overrid|e compon|
|00002260| 65 6e 74 73 2e 0d 20 20 | 20 2a 2f 0d 0d 70 61 73 |ents..  | */..pas|
|00002270| 63 61 6c 20 49 43 45 72 | 72 6f 72 20 49 43 43 44 |cal ICEr|ror ICCD|
|00002280| 65 66 61 75 6c 74 46 69 | 6c 65 4e 61 6d 65 28 69 |efaultFi|leName(i|
|00002290| 6e 74 65 72 6e 65 74 43 | 6f 6e 66 69 67 75 72 61 |nternetC|onfigura|
|000022a0| 74 69 6f 6e 43 6f 6d 70 | 6f 6e 65 6e 74 20 69 6e |tionComp|onent in|
|000022b0| 73 74 2c 20 53 74 72 36 | 33 20 6e 61 6d 65 29 0d |st, Str6|3 name).|
|000022c0| 46 49 56 45 57 4f 52 44 | 49 4e 4c 49 4e 45 28 30 |FIVEWORD|INLINE(0|
|000022d0| 78 32 46 33 43 2c 20 34 | 2c 20 31 31 2c 20 30 78 |x2F3C, 4|, 11, 0x|
|000022e0| 37 30 30 30 2c 20 30 78 | 41 38 32 41 29 3b 0d 20 |7000, 0x|A82A);. |
|000022f0| 20 2f 2a 20 59 6f 75 20 | 64 6f 20 6e 6f 74 20 68 | /* You |do not h|
|00002300| 61 76 65 20 74 6f 20 73 | 70 65 63 69 66 79 20 61 |ave to s|pecify a|
|00002310| 20 63 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 20 62 | configu|ration b|
|00002320| 65 66 6f 72 65 20 63 61 | 6c 6c 69 6e 67 20 74 68 |efore ca|lling th|
|00002330| 69 73 20 72 6f 75 74 69 | 6e 65 2e 0d 20 20 20 2a |is routi|ne..   *|
|00002340| 20 59 6f 75 20 64 6f 20 | 6e 6f 74 20 68 61 76 65 | You do |not have|
|00002350| 20 74 6f 20 62 65 20 69 | 6e 73 69 64 65 20 61 6e | to be i|nside an|
|00002360| 20 49 43 42 65 67 69 6e | 2f 45 6e 64 20 70 61 69 | ICBegin|/End pai|
|00002370| 72 20 74 6f 20 63 61 6c | 6c 20 74 68 69 73 20 72 |r to cal|l this r|
|00002380| 6f 75 74 69 6e 65 2e 0d | 20 20 20 2a 20 52 65 74 |outine..|   * Ret|
|00002390| 75 72 6e 73 20 74 68 65 | 20 64 65 66 61 75 6c 74 |urns the| default|
|000023a0| 20 66 69 6c 65 20 6e 61 | 6d 65 20 66 6f 72 20 49 | file na|me for I|
|000023b0| 43 20 70 72 65 66 65 72 | 65 6e 63 65 20 66 69 6c |C prefer|ence fil|
|000023c0| 65 73 2e 0d 20 20 20 2a | 20 41 70 70 6c 69 63 61 |es..   *| Applica|
|000023d0| 74 69 6f 6e 73 20 73 68 | 6f 75 6c 64 20 6e 65 76 |tions sh|ould nev|
|000023e0| 65 72 20 6e 65 65 64 20 | 74 6f 20 63 61 6c 6c 20 |er need |to call |
|000023f0| 74 68 69 73 20 72 6f 75 | 74 69 6e 65 2e 0d 20 20 |this rou|tine..  |
|00002400| 20 2a 20 49 66 20 79 6f | 75 20 72 65 6c 79 20 6f | * If yo|u rely o|
|00002410| 6e 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 72 65 |n inform|ation re|
|00002420| 74 75 72 6e 65 64 20 62 | 79 20 74 68 69 73 20 72 |turned b|y this r|
|00002430| 6f 75 74 69 6e 65 20 79 | 6f 75 72 73 65 6c 66 2c |outine y|ourself,|
|00002440| 0d 20 20 20 2a 20 79 6f | 75 20 6d 61 79 20 63 6f |.   * yo|u may co|
|00002450| 6e 66 6c 69 63 74 20 77 | 69 74 68 20 61 6e 79 20 |nflict w|ith any |
|00002460| 66 75 74 75 72 65 20 49 | 43 20 69 6d 70 6c 65 6d |future I|C implem|
|00002470| 65 6e 74 61 74 69 6f 6e | 20 74 68 61 74 20 64 6f |entation| that do|
|00002480| 65 73 6e 27 74 20 75 73 | 65 0d 20 20 20 2a 20 65 |esn't us|e.   * e|
|00002490| 78 70 6c 69 63 69 74 20 | 70 72 65 66 65 72 65 6e |xplicit |preferen|
|000024a0| 63 65 20 66 69 6c 65 73 | 2e 0d 20 20 20 2a 20 54 |ce files|..   * T|
|000024b0| 68 65 20 63 6f 6d 70 6f | 6e 65 6e 74 20 63 61 6c |he compo|nent cal|
|000024c0| 6c 73 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 20 |ls this |routine |
|000024d0| 74 6f 20 73 65 74 20 75 | 70 20 74 68 65 20 64 65 |to set u|p the de|
|000024e0| 66 61 75 6c 74 20 49 43 | 20 66 69 6c 65 20 6e 61 |fault IC| file na|
|000024f0| 6d 65 2e 0d 20 20 20 2a | 20 54 68 69 73 20 61 6c |me..   *| This al|
|00002500| 6c 6f 77 73 20 74 68 69 | 73 20 6f 70 65 72 61 74 |lows thi|s operat|
|00002510| 69 6f 6e 20 74 6f 20 62 | 65 20 69 6e 74 65 72 63 |ion to b|e interc|
|00002520| 65 70 74 65 64 20 62 79 | 20 61 20 63 6f 6d 70 6f |epted by| a compo|
|00002530| 6e 65 6e 74 20 74 68 61 | 74 20 68 61 73 0d 20 20 |nent tha|t has.  |
|00002540| 20 2a 20 63 61 70 74 75 | 72 65 64 20 75 73 2e 20 | * captu|red us. |
|00002550| 49 74 20 63 75 72 72 65 | 6e 74 6c 79 20 67 65 74 |It curre|ntly get|
|00002560| 73 20 69 74 20 66 72 6f | 6d 20 74 68 65 20 63 6f |s it fro|m the co|
|00002570| 6d 70 6f 6e 65 6e 74 20 | 72 65 73 6f 75 72 63 65 |mponent |resource|
|00002580| 20 66 69 6c 65 2e 0d 20 | 20 20 2a 20 54 68 65 20 | file.. |  * The |
|00002590| 67 6c 75 65 20 76 65 72 | 73 69 6f 6e 20 69 73 20 |glue ver|sion is |
|000025a0| 68 61 72 64 77 69 72 65 | 64 20 74 6f 20 22 49 6e |hardwire|d to "In|
|000025b0| 74 65 72 6e 65 74 20 50 | 72 65 66 65 72 65 6e 63 |ternet P|referenc|
|000025c0| 65 73 22 2e 0d 20 20 20 | 2a 2f 0d 0d 2f 2a 20 2a |es"..   |*/../* *|
|000025d0| 2a 2a 2a 2a 20 52 65 61 | 64 69 6e 67 20 61 6e 64 |**** Rea|ding and|
|000025e0| 20 57 72 69 74 69 6e 67 | 20 50 72 65 66 65 72 65 | Writing| Prefere|
|000025f0| 6e 63 65 73 20 2a 2a 2a | 2a 2a 20 2a 2f 0d 0d 70 |nces ***|** */..p|
|00002600| 61 73 63 61 6c 20 49 43 | 45 72 72 6f 72 20 49 43 |ascal IC|Error IC|
|00002610| 43 42 65 67 69 6e 28 69 | 6e 74 65 72 6e 65 74 43 |CBegin(i|nternetC|
|00002620| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 43 6f 6d 70 |onfigura|tionComp|
|00002630| 6f 6e 65 6e 74 20 69 6e | 73 74 2c 20 49 43 50 65 |onent in|st, ICPe|
|00002640| 72 6d 20 70 65 72 6d 29 | 0d 46 49 56 45 57 4f 52 |rm perm)|.FIVEWOR|
|00002650| 44 49 4e 4c 49 4e 45 28 | 30 78 32 46 33 43 2c 20 |DINLINE(|0x2F3C, |
|00002660| 32 2c 20 35 2c 20 30 78 | 37 30 30 30 2c 20 30 78 |2, 5, 0x|7000, 0x|
|00002670| 41 38 32 41 29 3b 0d 20 | 20 2f 2a 20 59 6f 75 20 |A82A);. | /* You |
|00002680| 6d 75 73 74 20 73 70 65 | 63 69 66 79 20 61 20 63 |must spe|cify a c|
|00002690| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 20 62 65 66 |onfigura|tion bef|
|000026a0| 6f 72 65 20 63 61 6c 6c | 69 6e 67 20 74 68 69 73 |ore call|ing this|
|000026b0| 20 72 6f 75 74 69 6e 65 | 2e 0d 20 20 20 2a 20 49 | routine|..   * I|
|000026c0| 74 20 69 73 20 69 6c 6c | 65 67 61 6c 20 74 6f 20 |t is ill|egal to |
|000026d0| 63 61 6c 6c 20 74 68 69 | 73 20 72 6f 75 74 69 6e |call thi|s routin|
|000026e0| 65 20 69 6e 73 69 64 65 | 20 61 20 49 43 42 65 67 |e inside| a ICBeg|
|000026f0| 69 6e 2f 45 6e 64 20 70 | 61 69 72 2e 0d 20 20 20 |in/End p|air..   |
|00002700| 2a 20 53 74 61 72 74 69 | 6e 67 20 72 65 61 64 69 |* Starti|ng readi|
|00002710| 6e 67 20 6f 72 20 77 72 | 69 74 69 6e 67 20 6d 75 |ng or wr|iting mu|
|00002720| 6c 74 69 70 6c 65 20 70 | 72 65 66 65 72 65 6e 63 |ltiple p|referenc|
|00002730| 65 73 2e 0d 20 20 20 2a | 20 41 20 63 61 6c 6c 20 |es..   *| A call |
|00002740| 74 6f 20 74 68 69 73 20 | 6d 75 73 74 20 62 65 20 |to this |must be |
|00002750| 62 61 6c 61 6e 63 65 64 | 20 62 79 20 61 20 63 61 |balanced| by a ca|
|00002760| 6c 6c 20 74 6f 20 49 43 | 45 6e 64 2e 0d 20 20 20 |ll to IC|End..   |
|00002770| 2a 20 44 6f 20 6e 6f 74 | 20 63 61 6c 6c 20 57 61 |* Do not| call Wa|
|00002780| 69 74 4e 65 78 74 45 76 | 65 6e 74 20 62 65 74 77 |itNextEv|ent betw|
|00002790| 65 65 6e 20 74 68 65 73 | 65 20 63 61 6c 6c 73 2e |een thes|e calls.|
|000027a0| 0d 20 20 20 2a 20 54 68 | 65 20 70 65 72 6d 20 73 |.   * Th|e perm s|
|000027b0| 70 65 63 69 66 69 65 73 | 20 77 68 65 74 68 65 72 |pecifies| whether|
|000027c0| 20 79 6f 75 20 69 6e 74 | 65 6e 64 20 74 6f 20 72 | you int|end to r|
|000027d0| 65 61 64 20 6f 72 20 72 | 65 61 64 2f 77 72 69 74 |ead or r|ead/writ|
|000027e0| 65 2e 0d 20 20 20 2a 20 | 4f 6e 6c 79 20 6f 6e 65 |e..   * |Only one|
|000027f0| 20 77 72 69 74 65 72 20 | 69 73 20 61 6c 6c 6f 77 | writer |is allow|
|00002800| 65 64 20 70 65 72 20 69 | 6e 73 74 61 6e 63 65 2e |ed per i|nstance.|
|00002810| 0d 20 20 20 2a 20 4e 6f | 74 65 20 74 68 61 74 20 |.   * No|te that |
|00002820| 74 68 69 73 20 6d 61 79 | 20 6f 70 65 6e 20 72 65 |this may| open re|
|00002830| 73 6f 75 72 63 65 20 66 | 69 6c 65 73 20 74 68 61 |source f|iles tha|
|00002840| 74 20 61 72 65 20 6e 6f | 74 20 63 6c 6f 73 65 64 |t are no|t closed|
|00002850| 0d 20 20 20 2a 20 75 6e | 74 69 6c 20 79 6f 75 20 |.   * un|til you |
|00002860| 63 61 6c 6c 20 49 43 45 | 6e 64 2e 0d 20 20 20 2a |call ICE|nd..   *|
|00002870| 2f 0d 0d 70 61 73 63 61 | 6c 20 49 43 45 72 72 6f |/..pasca|l ICErro|
|00002880| 72 20 49 43 43 47 65 74 | 50 72 65 66 28 69 6e 74 |r ICCGet|Pref(int|
|00002890| 65 72 6e 65 74 43 6f 6e | 66 69 67 75 72 61 74 69 |ernetCon|figurati|
|000028a0| 6f 6e 43 6f 6d 70 6f 6e | 65 6e 74 20 69 6e 73 74 |onCompon|ent inst|
|000028b0| 2c 20 43 6f 6e 73 74 53 | 74 72 32 35 35 50 61 72 |, ConstS|tr255Par|
|000028c0| 61 6d 20 6b 65 79 2c 20 | 49 43 41 74 74 72 20 2a |am key, |ICAttr *|
|000028d0| 61 74 74 72 2c 20 50 74 | 72 20 62 75 66 2c 20 6c |attr, Pt|r buf, l|
|000028e0| 6f 6e 67 20 2a 73 69 7a | 65 29 0d 46 49 56 45 57 |ong *siz|e).FIVEW|
|000028f0| 4f 52 44 49 4e 4c 49 4e | 45 28 30 78 32 46 33 43 |ORDINLIN|E(0x2F3C|
|00002900| 2c 20 31 36 2c 20 36 2c | 20 30 78 37 30 30 30 2c |, 16, 6,| 0x7000,|
|00002910| 20 30 78 41 38 32 41 29 | 3b 0d 20 20 2f 2a 20 59 | 0xA82A)|;.  /* Y|
|00002920| 6f 75 20 6d 75 73 74 20 | 73 70 65 63 69 66 79 20 |ou must |specify |
|00002930| 61 20 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 20 |a config|uration |
|00002940| 62 65 66 6f 72 65 20 63 | 61 6c 6c 69 6e 67 20 74 |before c|alling t|
|00002950| 68 69 73 20 72 6f 75 74 | 69 6e 65 2e 0d 20 20 20 |his rout|ine..   |
|00002960| 2a 20 49 66 20 79 6f 75 | 20 61 72 65 20 67 65 74 |* If you| are get|
|00002970| 74 69 6e 67 20 6f 72 20 | 73 65 74 74 69 6e 67 20 |ting or |setting |
|00002980| 6d 75 6c 74 69 70 6c 65 | 20 70 72 65 66 65 72 65 |multiple| prefere|
|00002990| 6e 63 65 73 2c 20 79 6f | 75 20 73 68 6f 75 6c 64 |nces, yo|u should|
|000029a0| 20 70 6c 61 63 65 0d 20 | 20 20 2a 20 74 68 65 73 | place. |  * thes|
|000029b0| 65 20 63 61 6c 6c 73 20 | 77 69 74 68 69 6e 20 61 |e calls |within a|
|000029c0| 6e 20 49 43 42 65 67 69 | 6e 2f 49 43 45 6e 64 20 |n ICBegi|n/ICEnd |
|000029d0| 70 61 69 72 2e 0d 20 20 | 20 2a 20 49 66 20 79 6f |pair..  | * If yo|
|000029e0| 75 20 63 61 6c 6c 20 74 | 68 69 73 20 72 6f 75 74 |u call t|his rout|
|000029f0| 69 6e 65 20 6f 75 74 73 | 69 64 65 20 6f 66 20 73 |ine outs|ide of s|
|00002a00| 75 63 68 20 61 20 70 61 | 69 72 2c 20 69 74 20 69 |uch a pa|ir, it i|
|00002a10| 6d 70 6c 69 63 69 74 6c | 79 0d 20 20 20 2a 20 63 |mplicitl|y.   * c|
|00002a20| 61 6c 6c 73 20 49 43 42 | 65 67 69 6e 28 69 6e 73 |alls ICB|egin(ins|
|00002a30| 74 2c 20 69 63 52 65 61 | 64 4f 6e 6c 79 50 65 72 |t, icRea|dOnlyPer|
|00002a40| 6d 29 2e 0d 20 20 20 2a | 20 52 65 61 64 73 20 74 |m)..   *| Reads t|
|00002a50| 68 65 20 70 72 65 66 65 | 72 65 6e 63 65 20 73 70 |he prefe|rence sp|
|00002a60| 65 63 69 66 69 65 64 20 | 62 79 20 6b 65 79 20 66 |ecified |by key f|
|00002a70| 72 6f 6d 20 74 68 65 20 | 49 43 20 64 61 74 61 62 |rom the |IC datab|
|00002a80| 61 73 65 20 74 6f 20 74 | 68 65 0d 20 20 20 2a 20 |ase to t|he.   * |
|00002a90| 62 75 66 66 65 72 20 70 | 6f 69 6e 74 65 64 20 74 |buffer p|ointed t|
|00002aa0| 6f 20 62 79 20 62 75 66 | 20 61 6e 64 20 73 69 7a |o by buf| and siz|
|00002ab0| 65 2e 0d 20 20 20 2a 20 | 6b 65 79 20 6d 75 73 74 |e..   * |key must|
|00002ac0| 20 6e 6f 74 20 62 65 20 | 74 68 65 20 65 6d 70 74 | not be |the empt|
|00002ad0| 79 20 73 74 72 69 6e 67 | 2e 0d 20 20 20 2a 20 49 |y string|..   * I|
|00002ae0| 66 20 62 75 66 20 69 73 | 20 6e 69 6c 20 74 68 65 |f buf is| nil the|
|00002af0| 6e 20 6e 6f 20 64 61 74 | 61 20 69 73 20 72 65 74 |n no dat|a is ret|
|00002b00| 75 72 6e 65 64 2e 0d 20 | 20 20 2a 20 73 69 7a 65 |urned.. |  * size|
|00002b10| 20 6d 75 73 74 20 62 65 | 20 6e 6f 6e 2d 6e 65 67 | must be| non-neg|
|00002b20| 61 74 69 76 65 2e 0d 20 | 20 20 2a 20 61 74 74 72 |ative.. |  * attr|
|00002b30| 20 61 6e 64 20 73 69 7a | 65 20 61 72 65 20 61 6c | and siz|e are al|
|00002b40| 77 61 79 73 20 73 65 74 | 20 6f 6e 20 72 65 74 75 |ways set| on retu|
|00002b50| 72 6e 2e 20 4f 6e 20 65 | 72 72 6f 72 73 20 28 65 |rn. On e|rrors (e|
|00002b60| 78 63 65 70 74 20 69 63 | 54 72 75 6e 63 61 74 65 |xcept ic|Truncate|
|00002b70| 64 45 72 72 29 0d 20 20 | 20 2a 20 61 74 74 72 20 |dErr).  | * attr |
|00002b80| 69 73 20 73 65 74 20 74 | 6f 20 49 43 61 74 74 72 |is set t|o ICattr|
|00002b90| 5f 6e 6f 5f 63 68 61 6e | 67 65 20 61 6e 64 20 73 |_no_chan|ge and s|
|00002ba0| 69 7a 65 20 69 73 20 73 | 65 74 20 74 6f 20 30 2e |ize is s|et to 0.|
|00002bb0| 0d 20 20 20 2a 20 73 69 | 7a 65 20 69 73 20 74 68 |.   * si|ze is th|
|00002bc0| 65 20 61 63 74 75 61 6c | 20 73 69 7a 65 20 6f 66 |e actual| size of|
|00002bd0| 20 74 68 65 20 64 61 74 | 61 2e 0d 20 20 20 2a 20 | the dat|a..   * |
|00002be0| 61 74 74 72 20 69 73 20 | 73 65 74 20 74 6f 20 74 |attr is |set to t|
|00002bf0| 68 65 20 61 74 74 72 69 | 62 75 74 65 73 20 61 73 |he attri|butes as|
|00002c00| 73 6f 63 69 61 74 65 64 | 20 77 69 74 68 20 74 68 |sociated| with th|
|00002c10| 65 20 70 72 65 66 65 72 | 65 6e 63 65 2e 0d 20 20 |e prefer|ence..  |
|00002c20| 20 2a 20 49 66 20 74 68 | 69 73 20 72 6f 75 74 69 | * If th|is routi|
|00002c30| 6e 65 20 72 65 74 75 72 | 6e 73 20 69 63 54 72 75 |ne retur|ns icTru|
|00002c40| 6e 63 61 74 65 64 45 72 | 72 20 74 68 65 6e 20 74 |ncatedEr|r then t|
|00002c50| 68 65 20 6f 74 68 65 72 | 20 72 65 74 75 72 6e 65 |he other| returne|
|00002c60| 64 0d 20 20 20 2a 20 76 | 61 6c 75 65 73 20 61 72 |d.   * v|alues ar|
|00002c70| 65 20 76 61 6c 69 64 20 | 65 78 63 65 70 74 20 74 |e valid |except t|
|00002c80| 68 61 74 20 6f 6e 6c 79 | 20 74 68 65 20 66 69 72 |hat only| the fir|
|00002c90| 73 74 20 73 69 7a 65 20 | 62 79 74 65 73 20 68 61 |st size |bytes ha|
|00002ca0| 76 65 20 62 65 65 6e 0d | 20 20 20 2a 20 72 65 74 |ve been.|   * ret|
|00002cb0| 75 72 6e 2e 20 73 69 7a | 65 20 69 73 20 61 64 6a |urn. siz|e is adj|
|00002cc0| 75 73 74 65 64 20 74 6f | 20 72 65 66 6c 65 63 74 |usted to| reflect|
|00002cd0| 20 74 68 65 20 74 72 75 | 65 20 73 69 7a 65 20 6f | the tru|e size o|
|00002ce0| 66 20 74 68 65 20 70 72 | 65 66 65 72 65 6e 63 65 |f the pr|eference|
|00002cf0| 2e 0d 20 20 20 2a 20 52 | 65 74 75 72 6e 73 20 69 |..   * R|eturns i|
|00002d00| 63 50 72 65 66 4e 6f 74 | 46 6f 75 6e 64 20 69 66 |cPrefNot|Found if|
|00002d10| 20 74 68 65 72 65 20 69 | 73 20 6e 6f 20 70 72 65 | there i|s no pre|
|00002d20| 66 65 72 65 6e 63 65 20 | 66 6f 72 20 74 68 65 20 |ference |for the |
|00002d30| 6b 65 79 2e 0d 20 20 20 | 2a 2f 0d 0d 70 61 73 63 |key..   |*/..pasc|
|00002d40| 61 6c 20 49 43 45 72 72 | 6f 72 20 49 43 43 53 65 |al ICErr|or ICCSe|
|00002d50| 74 50 72 65 66 28 69 6e | 74 65 72 6e 65 74 43 6f |tPref(in|ternetCo|
|00002d60| 6e 66 69 67 75 72 61 74 | 69 6f 6e 43 6f 6d 70 6f |nfigurat|ionCompo|
|00002d70| 6e 65 6e 74 20 69 6e 73 | 74 2c 20 43 6f 6e 73 74 |nent ins|t, Const|
|00002d80| 53 74 72 32 35 35 50 61 | 72 61 6d 20 6b 65 79 2c |Str255Pa|ram key,|
|00002d90| 20 49 43 41 74 74 72 20 | 61 74 74 72 2c 20 50 74 | ICAttr |attr, Pt|
|00002da0| 72 20 62 75 66 2c 20 6c | 6f 6e 67 20 73 69 7a 65 |r buf, l|ong size|
|00002db0| 29 0d 46 49 56 45 57 4f | 52 44 49 4e 4c 49 4e 45 |).FIVEWO|RDINLINE|
|00002dc0| 28 30 78 32 46 33 43 2c | 20 31 36 2c 20 37 2c 20 |(0x2F3C,| 16, 7, |
|00002dd0| 30 78 37 30 30 30 2c 20 | 30 78 41 38 32 41 29 3b |0x7000, |0xA82A);|
|00002de0| 0d 20 20 2f 2a 20 59 6f | 75 20 6d 75 73 74 20 73 |.  /* Yo|u must s|
|00002df0| 70 65 63 69 66 79 20 61 | 20 63 6f 6e 66 69 67 75 |pecify a| configu|
|00002e00| 72 61 74 69 6f 6e 20 62 | 65 66 6f 72 65 20 63 61 |ration b|efore ca|
|00002e10| 6c 6c 69 6e 67 20 74 68 | 69 73 20 72 6f 75 74 69 |lling th|is routi|
|00002e20| 6e 65 2e 0d 20 20 20 2a | 20 49 66 20 79 6f 75 20 |ne..   *| If you |
|00002e30| 61 72 65 20 67 65 74 74 | 69 6e 67 20 6f 72 20 73 |are gett|ing or s|
|00002e40| 65 74 74 69 6e 67 20 6d | 75 6c 74 69 70 6c 65 20 |etting m|ultiple |
|00002e50| 70 72 65 66 65 72 65 6e | 63 65 73 2c 20 79 6f 75 |preferen|ces, you|
|00002e60| 20 73 68 6f 75 6c 64 20 | 70 6c 61 63 65 0d 20 20 | should |place.  |
|00002e70| 20 2a 20 74 68 65 73 65 | 20 63 61 6c 6c 73 20 77 | * these| calls w|
|00002e80| 69 74 68 69 6e 20 61 6e | 20 49 43 42 65 67 69 6e |ithin an| ICBegin|
|00002e90| 2f 49 43 45 6e 64 20 70 | 61 69 72 2e 0d 20 20 20 |/ICEnd p|air..   |
|00002ea0| 2a 20 49 66 20 79 6f 75 | 20 63 61 6c 6c 20 74 68 |* If you| call th|
|00002eb0| 69 73 20 72 6f 75 74 69 | 6e 65 20 6f 75 74 73 69 |is routi|ne outsi|
|00002ec0| 64 65 20 6f 66 20 73 75 | 63 68 20 61 20 70 61 69 |de of su|ch a pai|
|00002ed0| 72 2c 20 69 74 20 69 6d | 70 6c 69 63 69 74 6c 79 |r, it im|plicitly|
|00002ee0| 0d 20 20 20 2a 20 63 61 | 6c 6c 73 20 49 43 42 65 |.   * ca|lls ICBe|
|00002ef0| 67 69 6e 28 69 6e 73 74 | 2c 20 69 63 52 65 61 64 |gin(inst|, icRead|
|00002f00| 57 72 69 74 65 50 65 72 | 6d 29 2e 0d 20 20 20 2a |WritePer|m)..   *|
|00002f10| 20 53 65 74 73 20 74 68 | 65 20 70 72 65 66 65 72 | Sets th|e prefer|
|00002f20| 65 6e 63 65 20 73 70 65 | 63 69 66 69 65 64 20 62 |ence spe|cified b|
|00002f30| 79 20 6b 65 79 20 66 72 | 6f 6d 20 74 68 65 20 49 |y key fr|om the I|
|00002f40| 43 20 64 61 74 61 62 61 | 73 65 20 74 6f 20 74 68 |C databa|se to th|
|00002f50| 65 0d 20 20 20 2a 20 76 | 61 6c 75 65 20 70 6f 69 |e.   * v|alue poi|
|00002f60| 6e 74 65 64 20 74 6f 20 | 62 79 20 62 75 66 20 61 |nted to |by buf a|
|00002f70| 6e 64 20 73 69 7a 65 2e | 0d 20 20 20 2a 20 6b 65 |nd size.|.   * ke|
|00002f80| 79 20 6d 75 73 74 20 6e | 6f 74 20 62 65 20 74 68 |y must n|ot be th|
|00002f90| 65 20 65 6d 70 74 79 20 | 73 74 72 69 6e 67 2e 0d |e empty |string..|
|00002fa0| 20 20 20 2a 20 73 69 7a | 65 20 6d 75 73 74 20 62 |   * siz|e must b|
|00002fb0| 65 20 6e 6f 6e 2d 6e 65 | 67 61 74 69 76 65 2e 20 |e non-ne|gative. |
|00002fc0| 0d 20 20 20 2a 20 49 66 | 20 62 75 66 20 69 73 20 |.   * If| buf is |
|00002fd0| 6e 69 6c 20 74 68 65 6e | 20 74 68 65 20 70 72 65 |nil then| the pre|
|00002fe0| 66 65 72 65 6e 63 65 20 | 76 61 6c 75 65 20 69 73 |ference |value is|
|00002ff0| 20 6e 6f 74 20 73 65 74 | 20 61 6e 64 20 73 69 7a | not set| and siz|
|00003000| 65 20 69 73 20 69 67 6e | 6f 72 65 64 2e 0d 20 20 |e is ign|ored..  |
|00003010| 20 2a 20 49 66 20 62 75 | 66 20 69 73 20 6e 6f 74 | * If bu|f is not|
|00003020| 20 6e 69 6c 20 74 68 65 | 6e 20 74 68 65 20 70 72 | nil the|n the pr|
|00003030| 65 66 65 72 65 6e 63 65 | 20 76 61 6c 75 65 20 69 |eference| value i|
|00003040| 73 20 73 65 74 20 74 6f | 20 74 68 65 20 73 69 7a |s set to| the siz|
|00003050| 65 0d 20 20 20 2a 20 62 | 79 74 65 73 20 70 6f 69 |e.   * b|ytes poi|
|00003060| 6e 74 65 64 20 74 6f 20 | 62 79 20 62 75 66 2e 0d |nted to |by buf..|
|00003070| 20 20 20 2a 20 49 66 20 | 61 74 74 72 20 69 73 20 |   * If |attr is |
|00003080| 49 43 61 74 74 72 5f 6e | 6f 5f 63 68 61 6e 67 65 |ICattr_n|o_change|
|00003090| 20 74 68 65 6e 20 74 68 | 65 20 70 72 65 66 65 72 | then th|e prefer|
|000030a0| 65 6e 63 65 20 61 74 74 | 72 69 62 75 74 65 73 20 |ence att|ributes |
|000030b0| 61 72 65 20 6e 6f 74 20 | 73 65 74 2e 0d 20 20 20 |are not |set..   |
|000030c0| 2a 20 4f 74 68 65 72 77 | 69 73 65 20 74 68 65 20 |* Otherw|ise the |
|000030d0| 70 72 65 66 65 72 65 6e | 63 65 20 61 74 74 72 69 |preferen|ce attri|
|000030e0| 62 75 74 65 73 20 61 72 | 65 20 73 65 74 20 74 6f |butes ar|e set to|
|000030f0| 20 61 74 74 72 2e 0d 20 | 20 20 2a 20 52 65 74 75 | attr.. |  * Retu|
|00003100| 72 6e 73 20 69 63 50 65 | 72 6d 45 72 72 20 69 66 |rns icPe|rmErr if|
|00003110| 20 74 68 65 20 70 72 65 | 76 69 6f 75 73 20 49 43 | the pre|vious IC|
|00003120| 42 65 67 69 6e 20 77 61 | 73 20 70 61 73 73 65 64 |Begin wa|s passed|
|00003130| 20 69 63 52 65 61 64 4f | 6e 6c 79 50 65 72 6d 2e | icReadO|nlyPerm.|
|00003140| 0d 20 20 20 2a 20 52 65 | 74 75 72 6e 73 20 69 63 |.   * Re|turns ic|
|00003150| 50 65 72 6d 45 72 72 20 | 69 66 20 63 75 72 72 65 |PermErr |if curre|
|00003160| 6e 74 20 61 74 74 72 20 | 69 73 20 6c 6f 63 6b 65 |nt attr |is locke|
|00003170| 64 2c 20 6e 65 77 20 61 | 74 74 72 20 69 73 20 6c |d, new a|ttr is l|
|00003180| 6f 63 6b 65 64 20 61 6e | 64 20 62 75 66 20 3c 3e |ocked an|d buf <>|
|00003190| 20 6e 69 6c 2e 0d 20 20 | 20 2a 2f 0d 0d 70 61 73 | nil..  | */..pas|
|000031a0| 63 61 6c 20 49 43 45 72 | 72 6f 72 20 49 43 43 46 |cal ICEr|ror ICCF|
|000031b0| 69 6e 64 50 72 65 66 48 | 61 6e 64 6c 65 28 69 6e |indPrefH|andle(in|
|000031c0| 74 65 72 6e 65 74 43 6f | 6e 66 69 67 75 72 61 74 |ternetCo|nfigurat|
|000031d0| 69 6f 6e 43 6f 6d 70 6f | 6e 65 6e 74 20 69 6e 73 |ionCompo|nent ins|
|000031e0| 74 2c 20 43 6f 6e 73 74 | 53 74 72 32 35 35 50 61 |t, Const|Str255Pa|
|000031f0| 72 61 6d 20 6b 65 79 2c | 20 49 43 41 74 74 72 20 |ram key,| ICAttr |
|00003200| 2a 61 74 74 72 2c 20 48 | 61 6e 64 6c 65 20 70 72 |*attr, H|andle pr|
|00003210| 65 66 68 29 0d 46 49 56 | 45 57 4f 52 44 49 4e 4c |efh).FIV|EWORDINL|
|00003220| 49 4e 45 28 30 78 32 46 | 33 43 2c 20 31 32 2c 20 |INE(0x2F|3C, 12, |
|00003230| 33 36 2c 20 30 78 37 30 | 30 30 2c 20 30 78 41 38 |36, 0x70|00, 0xA8|
|00003240| 32 41 29 3b 0d 20 20 2f | 2a 20 52 65 71 75 69 72 |2A);.  /|* Requir|
|00003250| 65 73 20 49 43 20 31 2e | 32 2e 0d 20 20 20 2a 20 |es IC 1.|2..   * |
|00003260| 59 6f 75 20 6d 75 73 74 | 20 73 70 65 63 69 66 79 |You must| specify|
|00003270| 20 61 20 63 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e | a confi|guration|
|00003280| 20 62 65 66 6f 72 65 20 | 63 61 6c 6c 69 6e 67 20 | before |calling |
|00003290| 74 68 69 73 20 72 6f 75 | 74 69 6e 65 2e 0d 20 20 |this rou|tine..  |
|000032a0| 20 2a 20 49 66 20 79 6f | 75 20 61 72 65 20 67 65 | * If yo|u are ge|
|000032b0| 74 74 69 6e 67 20 6f 72 | 20 73 65 74 74 69 6e 67 |tting or| setting|
|000032c0| 20 6d 75 6c 74 69 70 6c | 65 20 70 72 65 66 65 72 | multipl|e prefer|
|000032d0| 65 6e 63 65 73 2c 20 79 | 6f 75 20 73 68 6f 75 6c |ences, y|ou shoul|
|000032e0| 64 20 70 6c 61 63 65 0d | 20 20 20 2a 20 74 68 65 |d place.|   * the|
|000032f0| 73 65 20 63 61 6c 6c 73 | 20 77 69 74 68 69 6e 20 |se calls| within |
|00003300| 61 6e 20 49 43 42 65 67 | 69 6e 2f 49 43 45 6e 64 |an ICBeg|in/ICEnd|
|00003310| 20 70 61 69 72 2e 0d 20 | 20 20 2a 20 49 66 20 79 | pair.. |  * If y|
|00003320| 6f 75 20 63 61 6c 6c 20 | 74 68 69 73 20 72 6f 75 |ou call |this rou|
|00003330| 74 69 6e 65 20 6f 75 74 | 73 69 64 65 20 6f 66 20 |tine out|side of |
|00003340| 73 75 63 68 20 61 20 70 | 61 69 72 2c 20 69 74 20 |such a p|air, it |
|00003350| 69 6d 70 6c 69 63 69 74 | 6c 79 0d 20 20 20 2a 20 |implicit|ly.   * |
|00003360| 63 61 6c 6c 73 20 49 43 | 42 65 67 69 6e 28 69 6e |calls IC|Begin(in|
|00003370| 73 74 2c 20 69 63 52 65 | 61 64 57 72 69 74 65 50 |st, icRe|adWriteP|
|00003380| 65 72 6d 29 2e 0d 20 20 | 20 2a 20 54 68 69 73 20 |erm)..  | * This |
|00003390| 72 6f 75 74 69 6e 65 20 | 65 66 66 65 63 74 69 76 |routine |effectiv|
|000033a0| 65 6c 79 20 72 65 70 6c | 61 63 65 73 20 49 43 47 |ely repl|aces ICG|
|000033b0| 65 74 50 72 65 66 48 61 | 6e 64 6c 65 2e 0d 20 20 |etPrefHa|ndle..  |
|000033c0| 20 2a 20 52 65 61 64 73 | 20 74 68 65 20 70 72 65 | * Reads| the pre|
|000033d0| 66 65 72 65 6e 63 65 20 | 73 70 65 63 69 66 69 65 |ference |specifie|
|000033e0| 64 20 62 79 20 6b 65 79 | 20 66 72 6f 6d 20 74 68 |d by key| from th|
|000033f0| 65 20 49 43 20 64 61 74 | 61 62 61 73 65 20 69 6e |e IC dat|abase in|
|00003400| 74 6f 0d 20 20 20 2a 20 | 61 20 68 61 6e 64 6c 65 |to.   * |a handle|
|00003410| 2c 20 70 72 65 66 68 2e | 0d 20 20 20 2a 20 6b 65 |, prefh.|.   * ke|
|00003420| 79 20 6d 75 73 74 20 6e | 6f 74 20 62 65 20 74 68 |y must n|ot be th|
|00003430| 65 20 65 6d 70 74 79 20 | 73 74 72 69 6e 67 2e 0d |e empty |string..|
|00003440| 20 20 20 2a 20 61 74 74 | 72 20 69 73 20 73 65 74 |   * att|r is set|
|00003450| 20 74 6f 20 74 68 65 20 | 61 74 74 72 69 62 75 74 | to the |attribut|
|00003460| 65 73 20 61 73 73 6f 63 | 69 61 74 65 64 20 77 69 |es assoc|iated wi|
|00003470| 74 68 20 74 68 65 20 70 | 72 65 66 65 72 65 6e 63 |th the p|referenc|
|00003480| 65 2e 0d 20 20 20 2a 20 | 59 6f 75 20 6d 75 73 74 |e..   * |You must|
|00003490| 20 73 65 74 20 70 72 65 | 66 68 20 74 6f 20 61 20 | set pre|fh to a |
|000034a0| 6e 6f 6e 2d 6e 69 6c 20 | 68 61 6e 64 6c 65 20 62 |non-nil |handle b|
|000034b0| 65 66 6f 72 65 20 63 61 | 6c 6c 69 6e 67 20 74 68 |efore ca|lling th|
|000034c0| 69 73 20 72 6f 75 74 69 | 6e 65 2e 0d 20 20 20 2a |is routi|ne..   *|
|000034d0| 20 49 66 20 74 68 65 20 | 70 72 65 66 65 72 65 6e | If the |preferen|
|000034e0| 63 65 20 64 6f 65 73 20 | 6e 6f 74 20 65 78 69 73 |ce does |not exis|
|000034f0| 74 2c 20 69 63 50 72 65 | 66 4e 6f 74 46 6f 75 6e |t, icPre|fNotFoun|
|00003500| 64 45 72 72 20 69 73 20 | 72 65 74 75 72 6e 65 64 |dErr is |returned|
|00003510| 2e 0d 20 20 20 2a 2f 0d | 0d 70 61 73 63 61 6c 20 |..   */.|.pascal |
|00003520| 49 43 45 72 72 6f 72 20 | 49 43 43 47 65 74 50 72 |ICError |ICCGetPr|
|00003530| 65 66 48 61 6e 64 6c 65 | 28 69 6e 74 65 72 6e 65 |efHandle|(interne|
|00003540| 74 43 6f 6e 66 69 67 75 | 72 61 74 69 6f 6e 43 6f |tConfigu|rationCo|
|00003550| 6d 70 6f 6e 65 6e 74 20 | 69 6e 73 74 2c 20 43 6f |mponent |inst, Co|
|00003560| 6e 73 74 53 74 72 32 35 | 35 50 61 72 61 6d 20 6b |nstStr25|5Param k|
|00003570| 65 79 2c 20 49 43 41 74 | 74 72 20 2a 61 74 74 72 |ey, ICAt|tr *attr|
|00003580| 2c 20 48 61 6e 64 6c 65 | 20 2a 70 72 65 66 68 29 |, Handle| *prefh)|
|00003590| 0d 46 49 56 45 57 4f 52 | 44 49 4e 4c 49 4e 45 28 |.FIVEWOR|DINLINE(|
|000035a0| 30 78 32 46 33 43 2c 20 | 31 32 2c 20 32 36 2c 20 |0x2F3C, |12, 26, |
|000035b0| 30 78 37 30 30 30 2c 20 | 30 78 41 38 32 41 29 3b |0x7000, |0xA82A);|
|000035c0| 0d 20 20 2f 2a 20 52 65 | 71 75 69 72 65 73 20 49 |.  /* Re|quires I|
|000035d0| 43 20 31 2e 31 2e 0d 20 | 20 20 2a 20 59 6f 75 20 |C 1.1.. |  * You |
|000035e0| 6d 75 73 74 20 73 70 65 | 63 69 66 79 20 61 20 63 |must spe|cify a c|
|000035f0| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 20 62 65 66 |onfigura|tion bef|
|00003600| 6f 72 65 20 63 61 6c 6c | 69 6e 67 20 74 68 69 73 |ore call|ing this|
|00003610| 20 72 6f 75 74 69 6e 65 | 2e 0d 20 20 20 2a 20 49 | routine|..   * I|
|00003620| 66 20 79 6f 75 20 61 72 | 65 20 67 65 74 74 69 6e |f you ar|e gettin|
|00003630| 67 20 6f 72 20 73 65 74 | 74 69 6e 67 20 6d 75 6c |g or set|ting mul|
|00003640| 74 69 70 6c 65 20 70 72 | 65 66 65 72 65 6e 63 65 |tiple pr|eference|
|00003650| 73 2c 20 79 6f 75 20 73 | 68 6f 75 6c 64 20 70 6c |s, you s|hould pl|
|00003660| 61 63 65 0d 20 20 20 2a | 20 74 68 65 73 65 20 63 |ace.   *| these c|
|00003670| 61 6c 6c 73 20 77 69 74 | 68 69 6e 20 61 6e 20 49 |alls wit|hin an I|
|00003680| 43 42 65 67 69 6e 2f 49 | 43 45 6e 64 20 70 61 69 |CBegin/I|CEnd pai|
|00003690| 72 2e 0d 20 20 20 2a 20 | 49 66 20 79 6f 75 20 63 |r..   * |If you c|
|000036a0| 61 6c 6c 20 74 68 69 73 | 20 72 6f 75 74 69 6e 65 |all this| routine|
|000036b0| 20 6f 75 74 73 69 64 65 | 20 6f 66 20 73 75 63 68 | outside| of such|
|000036c0| 20 61 20 70 61 69 72 2c | 20 69 74 20 69 6d 70 6c | a pair,| it impl|
|000036d0| 69 63 69 74 6c 79 0d 20 | 20 20 2a 20 63 61 6c 6c |icitly. |  * call|
|000036e0| 73 20 49 43 42 65 67 69 | 6e 28 69 6e 73 74 2c 20 |s ICBegi|n(inst, |
|000036f0| 69 63 52 65 61 64 4f 6e | 6c 79 50 65 72 6d 29 2e |icReadOn|lyPerm).|
|00003700| 0d 20 20 20 2a 20 54 68 | 69 73 20 72 6f 75 74 69 |.   * Th|is routi|
|00003710| 6e 65 20 69 73 20 6e 6f | 77 20 6f 62 73 6f 6c 65 |ne is no|w obsole|
|00003720| 74 65 2e 20 55 73 65 20 | 49 43 46 69 6e 64 50 72 |te. Use |ICFindPr|
|00003730| 65 66 48 61 6e 64 6c 65 | 20 69 6e 73 74 65 61 64 |efHandle| instead|
|00003740| 2e 0d 20 20 20 2a 20 52 | 65 61 64 73 20 74 68 65 |..   * R|eads the|
|00003750| 20 70 72 65 66 65 72 65 | 6e 63 65 20 73 70 65 63 | prefere|nce spec|
|00003760| 69 66 69 65 64 20 62 79 | 20 6b 65 79 20 66 72 6f |ified by| key fro|
|00003770| 6d 20 74 68 65 20 49 43 | 20 64 61 74 61 62 61 73 |m the IC| databas|
|00003780| 65 20 69 6e 74 6f 0d 20 | 20 20 2a 20 61 20 6e 65 |e into. |  * a ne|
|00003790| 77 6c 79 20 63 72 65 61 | 74 65 64 20 68 61 6e 64 |wly crea|ted hand|
|000037a0| 6c 65 2c 20 70 72 65 66 | 68 2e 0d 20 20 20 2a 20 |le, pref|h..   * |
|000037b0| 6b 65 79 20 6d 75 73 74 | 20 6e 6f 74 20 62 65 20 |key must| not be |
|000037c0| 74 68 65 20 65 6d 70 74 | 79 20 73 74 72 69 6e 67 |the empt|y string|
|000037d0| 2e 0d 20 20 20 2a 20 61 | 74 74 72 20 69 73 20 73 |..   * a|ttr is s|
|000037e0| 65 74 20 74 6f 20 74 68 | 65 20 61 74 74 72 69 62 |et to th|e attrib|
|000037f0| 75 74 65 73 20 61 73 73 | 6f 63 69 61 74 65 64 20 |utes ass|ociated |
|00003800| 77 69 74 68 20 74 68 65 | 20 70 72 65 66 65 72 65 |with the| prefere|
|00003810| 6e 63 65 2e 0d 20 20 20 | 2a 20 54 68 65 20 69 6e |nce..   |* The in|
|00003820| 63 6f 6d 69 6e 67 20 76 | 61 6c 75 65 20 6f 66 20 |coming v|alue of |
|00003830| 70 72 65 66 68 20 69 73 | 20 69 67 6e 6f 72 65 64 |prefh is| ignored|
|00003840| 2e 0d 20 20 20 2a 20 41 | 20 6e 65 77 20 68 61 6e |..   * A| new han|
|00003850| 64 6c 65 20 69 73 20 63 | 72 65 61 74 65 64 20 69 |dle is c|reated i|
|00003860| 6e 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 68 65 |n the cu|rrent he|
|00003870| 61 70 20 61 6e 64 20 72 | 65 74 75 72 6e 65 64 20 |ap and r|eturned |
|00003880| 69 6e 20 70 72 65 66 68 | 2e 0d 20 20 20 2a 20 49 |in prefh|..   * I|
|00003890| 66 20 74 68 65 20 72 6f | 75 74 69 6e 65 20 72 65 |f the ro|utine re|
|000038a0| 74 75 72 6e 73 20 61 6e | 20 65 72 72 6f 72 2c 20 |turns an| error, |
|000038b0| 70 72 65 66 68 20 69 73 | 20 73 65 74 20 74 6f 20 |prefh is| set to |
|000038c0| 6e 69 6c 2e 0d 20 20 20 | 2a 20 49 66 20 74 68 65 |nil..   |* If the|
|000038d0| 20 70 72 65 66 65 72 65 | 6e 63 65 20 64 6f 65 73 | prefere|nce does|
|000038e0| 20 6e 6f 74 20 65 78 69 | 73 74 2c 20 6e 6f 20 65 | not exi|st, no e|
|000038f0| 72 72 6f 72 20 69 73 20 | 72 65 74 75 72 6e 65 64 |rror is |returned|
|00003900| 20 61 6e 64 20 70 72 65 | 66 68 20 69 73 20 73 65 | and pre|fh is se|
|00003910| 74 0d 20 20 20 2a 20 74 | 6f 20 61 6e 20 65 6d 70 |t.   * t|o an emp|
|00003920| 74 79 20 68 61 6e 64 6c | 65 2e 0d 20 20 20 2a 2f |ty handl|e..   */|
|00003930| 0d 0d 70 61 73 63 61 6c | 20 49 43 45 72 72 6f 72 |..pascal| ICError|
|00003940| 20 49 43 43 53 65 74 50 | 72 65 66 48 61 6e 64 6c | ICCSetP|refHandl|
|00003950| 65 28 69 6e 74 65 72 6e | 65 74 43 6f 6e 66 69 67 |e(intern|etConfig|
|00003960| 75 72 61 74 69 6f 6e 43 | 6f 6d 70 6f 6e 65 6e 74 |urationC|omponent|
|00003970| 20 69 6e 73 74 2c 20 43 | 6f 6e 73 74 53 74 72 32 | inst, C|onstStr2|
|00003980| 35 35 50 61 72 61 6d 20 | 6b 65 79 2c 20 49 43 41 |55Param |key, ICA|
|00003990| 74 74 72 20 61 74 74 72 | 2c 20 48 61 6e 64 6c 65 |ttr attr|, Handle|
|000039a0| 20 70 72 65 66 68 29 0d | 46 49 56 45 57 4f 52 44 | prefh).|FIVEWORD|
|000039b0| 49 4e 4c 49 4e 45 28 30 | 78 32 46 33 43 2c 20 31 |INLINE(0|x2F3C, 1|
|000039c0| 32 2c 20 32 37 2c 20 30 | 78 37 30 30 30 2c 20 30 |2, 27, 0|x7000, 0|
|000039d0| 78 41 38 32 41 29 3b 0d | 20 20 2f 2a 20 52 65 71 |xA82A);.|  /* Req|
|000039e0| 75 69 72 65 73 20 49 43 | 20 31 2e 31 2e 0d 20 20 |uires IC| 1.1..  |
|000039f0| 20 2a 20 59 6f 75 20 6d | 75 73 74 20 73 70 65 63 | * You m|ust spec|
|00003a00| 69 66 79 20 61 20 63 6f | 6e 66 69 67 75 72 61 74 |ify a co|nfigurat|
|00003a10| 69 6f 6e 20 62 65 66 6f | 72 65 20 63 61 6c 6c 69 |ion befo|re calli|
|00003a20| 6e 67 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 2e |ng this |routine.|
|00003a30| 0d 20 20 20 2a 20 49 66 | 20 79 6f 75 20 61 72 65 |.   * If| you are|
|00003a40| 20 67 65 74 74 69 6e 67 | 20 6f 72 20 73 65 74 74 | getting| or sett|
|00003a50| 69 6e 67 20 6d 75 6c 74 | 69 70 6c 65 20 70 72 65 |ing mult|iple pre|
|00003a60| 66 65 72 65 6e 63 65 73 | 2c 20 79 6f 75 20 73 68 |ferences|, you sh|
|00003a70| 6f 75 6c 64 20 70 6c 61 | 63 65 0d 20 20 20 2a 20 |ould pla|ce.   * |
|00003a80| 74 68 65 73 65 20 63 61 | 6c 6c 73 20 77 69 74 68 |these ca|lls with|
|00003a90| 69 6e 20 61 6e 20 49 43 | 42 65 67 69 6e 2f 49 43 |in an IC|Begin/IC|
|00003aa0| 45 6e 64 20 70 61 69 72 | 2e 0d 20 20 20 2a 20 49 |End pair|..   * I|
|00003ab0| 66 20 79 6f 75 20 63 61 | 6c 6c 20 74 68 69 73 20 |f you ca|ll this |
|00003ac0| 72 6f 75 74 69 6e 65 20 | 6f 75 74 73 69 64 65 20 |routine |outside |
|00003ad0| 6f 66 20 73 75 63 68 20 | 61 20 70 61 69 72 2c 20 |of such |a pair, |
|00003ae0| 69 74 20 69 6d 70 6c 69 | 63 69 74 6c 79 0d 20 20 |it impli|citly.  |
|00003af0| 20 2a 20 63 61 6c 6c 73 | 20 49 43 42 65 67 69 6e | * calls| ICBegin|
|00003b00| 28 69 6e 73 74 2c 20 69 | 63 52 65 61 64 57 72 69 |(inst, i|cReadWri|
|00003b10| 74 65 50 65 72 6d 29 2e | 0d 20 20 20 2a 20 53 65 |tePerm).|.   * Se|
|00003b20| 74 73 20 74 68 65 20 70 | 72 65 66 65 72 65 6e 63 |ts the p|referenc|
|00003b30| 65 20 73 70 65 63 69 66 | 69 65 64 20 62 79 20 6b |e specif|ied by k|
|00003b40| 65 79 20 66 72 6f 6d 20 | 74 68 65 20 49 43 20 64 |ey from |the IC d|
|00003b50| 61 74 61 62 61 73 65 20 | 74 6f 20 74 68 65 0d 20 |atabase |to the. |
|00003b60| 20 20 2a 20 76 61 6c 75 | 65 20 63 6f 6e 74 61 69 |  * valu|e contai|
|00003b70| 6e 65 64 20 69 6e 20 70 | 72 65 66 68 2e 0d 20 20 |ned in p|refh..  |
|00003b80| 20 2a 20 6b 65 79 20 6d | 75 73 74 20 6e 6f 74 20 | * key m|ust not |
|00003b90| 62 65 20 74 68 65 20 65 | 6d 70 74 79 20 73 74 72 |be the e|mpty str|
|00003ba0| 69 6e 67 2e 0d 20 20 20 | 2a 20 49 66 20 70 72 65 |ing..   |* If pre|
|00003bb0| 66 68 20 69 73 20 6e 69 | 6c 20 74 68 65 6e 20 74 |fh is ni|l then t|
|00003bc0| 68 65 20 70 72 65 66 65 | 72 65 6e 63 65 20 76 61 |he prefe|rence va|
|00003bd0| 6c 75 65 20 69 73 20 6e | 6f 74 20 73 65 74 2e 0d |lue is n|ot set..|
|00003be0| 20 20 20 2a 20 49 66 20 | 62 75 66 20 69 73 20 6e |   * If |buf is n|
|00003bf0| 6f 74 20 6e 69 6c 20 74 | 68 65 6e 20 74 68 65 20 |ot nil t|hen the |
|00003c00| 70 72 65 66 65 72 65 6e | 63 65 20 76 61 6c 75 65 |preferen|ce value|
|00003c10| 20 69 73 20 73 65 74 20 | 74 6f 20 74 68 65 20 64 | is set |to the d|
|00003c20| 61 74 61 0d 20 20 20 2a | 20 63 6f 6e 74 61 69 6e |ata.   *| contain|
|00003c30| 65 64 20 69 6e 20 69 74 | 2e 0d 20 20 20 2a 20 49 |ed in it|..   * I|
|00003c40| 66 20 61 74 74 72 20 69 | 73 20 49 43 61 74 74 72 |f attr i|s ICattr|
|00003c50| 5f 6e 6f 5f 63 68 61 6e | 67 65 20 74 68 65 6e 20 |_no_chan|ge then |
|00003c60| 74 68 65 20 70 72 65 66 | 65 72 65 6e 63 65 20 61 |the pref|erence a|
|00003c70| 74 74 72 69 62 75 74 65 | 73 20 61 72 65 20 6e 6f |ttribute|s are no|
|00003c80| 74 20 73 65 74 2e 0d 20 | 20 20 2a 20 4f 74 68 65 |t set.. |  * Othe|
|00003c90| 72 77 69 73 65 20 74 68 | 65 20 70 72 65 66 65 72 |rwise th|e prefer|
|00003ca0| 65 6e 63 65 20 61 74 74 | 72 69 62 75 74 65 73 20 |ence att|ributes |
|00003cb0| 61 72 65 20 73 65 74 20 | 74 6f 20 61 74 74 72 2e |are set |to attr.|
|00003cc0| 0d 20 20 20 2a 20 52 65 | 74 75 72 6e 73 20 69 63 |.   * Re|turns ic|
|00003cd0| 50 65 72 6d 45 72 72 20 | 69 66 20 74 68 65 20 70 |PermErr |if the p|
|00003ce0| 72 65 76 69 6f 75 73 20 | 49 43 42 65 67 69 6e 20 |revious |ICBegin |
|00003cf0| 77 61 73 20 70 61 73 73 | 65 64 20 69 63 52 65 61 |was pass|ed icRea|
|00003d00| 64 4f 6e 6c 79 50 65 72 | 6d 2e 0d 20 20 20 2a 20 |dOnlyPer|m..   * |
|00003d10| 52 65 74 75 72 6e 73 20 | 69 63 50 65 72 6d 45 72 |Returns |icPermEr|
|00003d20| 72 20 69 66 20 63 75 72 | 72 65 6e 74 20 61 74 74 |r if cur|rent att|
|00003d30| 72 20 69 73 20 6c 6f 63 | 6b 65 64 2c 20 6e 65 77 |r is loc|ked, new|
|00003d40| 20 61 74 74 72 20 69 73 | 20 6c 6f 63 6b 65 64 20 | attr is| locked |
|00003d50| 61 6e 64 20 70 72 65 66 | 68 20 3c 3e 20 6e 69 6c |and pref|h <> nil|
|00003d60| 2e 0d 20 20 20 2a 2f 0d | 0d 70 61 73 63 61 6c 20 |..   */.|.pascal |
|00003d70| 49 43 45 72 72 6f 72 20 | 49 43 43 43 6f 75 6e 74 |ICError |ICCCount|
|00003d80| 50 72 65 66 28 69 6e 74 | 65 72 6e 65 74 43 6f 6e |Pref(int|ernetCon|
|00003d90| 66 69 67 75 72 61 74 69 | 6f 6e 43 6f 6d 70 6f 6e |figurati|onCompon|
|00003da0| 65 6e 74 20 69 6e 73 74 | 2c 20 6c 6f 6e 67 20 2a |ent inst|, long *|
|00003db0| 63 6f 75 6e 74 29 0d 46 | 49 56 45 57 4f 52 44 49 |count).F|IVEWORDI|
|00003dc0| 4e 4c 49 4e 45 28 30 78 | 32 46 33 43 2c 20 34 2c |NLINE(0x|2F3C, 4,|
|00003dd0| 20 38 2c 20 30 78 37 30 | 30 30 2c 20 30 78 41 38 | 8, 0x70|00, 0xA8|
|00003de0| 32 41 29 3b 0d 20 20 2f | 2a 20 59 6f 75 20 6d 75 |2A);.  /|* You mu|
|00003df0| 73 74 20 73 70 65 63 69 | 66 79 20 61 20 63 6f 6e |st speci|fy a con|
|00003e00| 66 69 67 75 72 61 74 69 | 6f 6e 20 62 65 66 6f 72 |figurati|on befor|
|00003e10| 65 20 63 61 6c 6c 69 6e | 67 20 74 68 69 73 20 72 |e callin|g this r|
|00003e20| 6f 75 74 69 6e 65 2e 0d | 20 20 20 2a 20 59 6f 75 |outine..|   * You|
|00003e30| 20 6d 75 73 74 20 62 65 | 20 69 6e 73 69 64 65 20 | must be| inside |
|00003e40| 61 6e 20 49 43 42 65 67 | 69 6e 2f 45 6e 64 20 70 |an ICBeg|in/End p|
|00003e50| 61 69 72 20 74 6f 20 63 | 61 6c 6c 20 74 68 69 73 |air to c|all this|
|00003e60| 20 72 6f 75 74 69 6e 65 | 2e 0d 20 20 20 2a 20 43 | routine|..   * C|
|00003e70| 6f 75 6e 74 73 20 74 68 | 65 20 74 6f 74 61 6c 20 |ounts th|e total |
|00003e80| 6e 75 6d 62 65 72 20 6f | 66 20 70 72 65 66 65 72 |number o|f prefer|
|00003e90| 65 6e 63 65 73 2e 0d 20 | 20 20 2a 20 49 66 20 74 |ences.. |  * If t|
|00003ea0| 68 65 20 72 6f 75 74 69 | 6e 65 20 72 65 74 75 72 |he routi|ne retur|
|00003eb0| 6e 73 20 61 6e 20 65 72 | 72 6f 72 2c 20 63 6f 75 |ns an er|ror, cou|
|00003ec0| 6e 74 20 69 73 20 73 65 | 74 20 74 6f 20 30 2e 0d |nt is se|t to 0..|
|00003ed0| 20 20 20 2a 2f 0d 0d 70 | 61 73 63 61 6c 20 49 43 |   */..p|ascal IC|
|00003ee0| 45 72 72 6f 72 20 49 43 | 43 47 65 74 49 6e 64 50 |Error IC|CGetIndP|
|00003ef0| 72 65 66 28 69 6e 74 65 | 72 6e 65 74 43 6f 6e 66 |ref(inte|rnetConf|
|00003f00| 69 67 75 72 61 74 69 6f | 6e 43 6f 6d 70 6f 6e 65 |iguratio|nCompone|
|00003f10| 6e 74 20 69 6e 73 74 2c | 20 6c 6f 6e 67 20 6e 2c |nt inst,| long n,|
|00003f20| 20 53 74 72 32 35 35 20 | 6b 65 79 29 0d 46 49 56 | Str255 |key).FIV|
|00003f30| 45 57 4f 52 44 49 4e 4c | 49 4e 45 28 30 78 32 46 |EWORDINL|INE(0x2F|
|00003f40| 33 43 2c 20 38 2c 20 39 | 2c 20 30 78 37 30 30 30 |3C, 8, 9|, 0x7000|
|00003f50| 2c 20 30 78 41 38 32 41 | 29 3b 0d 20 20 2f 2a 20 |, 0xA82A|);.  /* |
|00003f60| 59 6f 75 20 6d 75 73 74 | 20 73 70 65 63 69 66 79 |You must| specify|
|00003f70| 20 61 20 63 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e | a confi|guration|
|00003f80| 20 62 65 66 6f 72 65 20 | 63 61 6c 6c 69 6e 67 20 | before |calling |
|00003f90| 74 68 69 73 20 72 6f 75 | 74 69 6e 65 2e 0d 20 20 |this rou|tine..  |
|00003fa0| 20 2a 20 59 6f 75 20 6d | 75 73 74 20 62 65 20 69 | * You m|ust be i|
|00003fb0| 6e 73 69 64 65 20 61 6e | 20 49 43 42 65 67 69 6e |nside an| ICBegin|
|00003fc0| 2f 45 6e 64 20 70 61 69 | 72 20 74 6f 20 63 61 6c |/End pai|r to cal|
|00003fd0| 6c 20 74 68 69 73 20 72 | 6f 75 74 69 6e 65 2e 0d |l this r|outine..|
|00003fe0| 20 20 20 2a 20 52 65 74 | 75 72 6e 73 20 74 68 65 |   * Ret|urns the|
|00003ff0| 20 6b 65 79 20 6f 66 20 | 74 68 65 20 4e 74 68 20 | key of |the Nth |
|00004000| 70 72 65 66 65 72 65 6e | 63 65 2e 0d 20 20 20 2a |preferen|ce..   *|
|00004010| 20 6e 20 6d 75 73 74 20 | 62 65 20 70 6f 73 69 74 | n must |be posit|
|00004020| 69 76 65 2e 0d 20 20 20 | 2a 20 52 65 74 75 72 6e |ive..   |* Return|
|00004030| 73 20 69 63 50 72 65 66 | 4e 6f 74 46 6f 75 6e 64 |s icPref|NotFound|
|00004040| 45 72 72 20 69 66 20 6e | 20 69 73 20 67 72 65 61 |Err if n| is grea|
|00004050| 74 65 72 20 74 68 61 6e | 20 74 68 65 20 74 6f 74 |ter than| the tot|
|00004060| 61 6c 20 6e 75 6d 62 65 | 72 20 6f 66 20 70 72 65 |al numbe|r of pre|
|00004070| 66 65 72 65 6e 63 65 73 | 2e 0d 20 20 20 2a 20 49 |ferences|..   * I|
|00004080| 66 20 74 68 65 20 72 6f | 75 74 69 6e 65 20 72 65 |f the ro|utine re|
|00004090| 74 75 72 6e 73 20 61 6e | 20 65 72 72 6f 72 2c 20 |turns an| error, |
|000040a0| 6b 65 79 20 69 73 20 75 | 6e 64 65 66 69 6e 65 64 |key is u|ndefined|
|000040b0| 2e 0d 20 20 20 2a 2f 0d | 0d 70 61 73 63 61 6c 20 |..   */.|.pascal |
|000040c0| 49 43 45 72 72 6f 72 20 | 49 43 43 44 65 6c 65 74 |ICError |ICCDelet|
|000040d0| 65 50 72 65 66 28 69 6e | 74 65 72 6e 65 74 43 6f |ePref(in|ternetCo|
|000040e0| 6e 66 69 67 75 72 61 74 | 69 6f 6e 43 6f 6d 70 6f |nfigurat|ionCompo|
|000040f0| 6e 65 6e 74 20 69 6e 73 | 74 2c 20 43 6f 6e 73 74 |nent ins|t, Const|
|00004100| 53 74 72 32 35 35 50 61 | 72 61 6d 20 6b 65 79 29 |Str255Pa|ram key)|
|00004110| 0d 46 49 56 45 57 4f 52 | 44 49 4e 4c 49 4e 45 28 |.FIVEWOR|DINLINE(|
|00004120| 30 78 32 46 33 43 2c 20 | 34 2c 20 31 32 2c 20 30 |0x2F3C, |4, 12, 0|
|00004130| 78 37 30 30 30 2c 20 30 | 78 41 38 32 41 29 3b 0d |x7000, 0|xA82A);.|
|00004140| 20 20 2f 2a 20 59 6f 75 | 20 6d 75 73 74 20 73 70 |  /* You| must sp|
|00004150| 65 63 69 66 79 20 61 20 | 63 6f 6e 66 69 67 75 72 |ecify a |configur|
|00004160| 61 74 69 6f 6e 20 62 65 | 66 6f 72 65 20 63 61 6c |ation be|fore cal|
|00004170| 6c 69 6e 67 20 74 68 69 | 73 20 72 6f 75 74 69 6e |ling thi|s routin|
|00004180| 65 2e 0d 20 20 20 2a 20 | 59 6f 75 20 6d 75 73 74 |e..   * |You must|
|00004190| 20 62 65 20 69 6e 73 69 | 64 65 20 61 6e 20 49 43 | be insi|de an IC|
|000041a0| 42 65 67 69 6e 2f 45 6e | 64 20 70 61 69 72 20 74 |Begin/En|d pair t|
|000041b0| 6f 20 63 61 6c 6c 20 74 | 68 69 73 20 72 6f 75 74 |o call t|his rout|
|000041c0| 69 6e 65 2e 0d 20 20 20 | 2a 20 44 65 6c 65 74 65 |ine..   |* Delete|
|000041d0| 73 20 74 68 65 20 70 72 | 65 66 65 72 65 6e 63 65 |s the pr|eference|
|000041e0| 20 73 70 65 63 69 66 69 | 65 64 20 62 79 20 6b 65 | specifi|ed by ke|
|000041f0| 79 2e 0d 20 20 20 2a 20 | 6b 65 79 20 6d 75 73 74 |y..   * |key must|
|00004200| 20 6e 6f 74 20 62 65 20 | 74 68 65 20 65 6d 70 74 | not be |the empt|
|00004210| 79 20 73 74 72 69 6e 67 | 2e 0d 20 20 20 2a 20 52 |y string|..   * R|
|00004220| 65 74 75 72 6e 73 20 69 | 63 50 72 65 66 4e 6f 74 |eturns i|cPrefNot|
|00004230| 46 6f 75 6e 64 20 69 66 | 20 74 68 65 20 70 72 65 |Found if| the pre|
|00004240| 66 65 72 65 6e 63 65 20 | 73 70 65 63 69 66 69 65 |ference |specifie|
|00004250| 64 20 62 79 20 6b 65 79 | 20 69 73 20 6e 6f 74 20 |d by key| is not |
|00004260| 70 72 65 73 65 6e 74 2e | 0d 20 20 20 2a 2f 0d 0d |present.|.   */..|
|00004270| 70 61 73 63 61 6c 20 49 | 43 45 72 72 6f 72 20 49 |pascal I|CError I|
|00004280| 43 43 45 6e 64 28 69 6e | 74 65 72 6e 65 74 43 6f |CCEnd(in|ternetCo|
|00004290| 6e 66 69 67 75 72 61 74 | 69 6f 6e 43 6f 6d 70 6f |nfigurat|ionCompo|
|000042a0| 6e 65 6e 74 20 69 6e 73 | 74 29 0d 46 49 56 45 57 |nent ins|t).FIVEW|
|000042b0| 4f 52 44 49 4e 4c 49 4e | 45 28 30 78 32 46 33 43 |ORDINLIN|E(0x2F3C|
|000042c0| 2c 20 30 2c 20 31 30 2c | 20 30 78 37 30 30 30 2c |, 0, 10,| 0x7000,|
|000042d0| 20 30 78 41 38 32 41 29 | 3b 0d 20 20 2f 2a 20 59 | 0xA82A)|;.  /* Y|
|000042e0| 6f 75 20 6d 75 73 74 20 | 73 70 65 63 69 66 79 20 |ou must |specify |
|000042f0| 61 20 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 20 |a config|uration |
|00004300| 62 65 66 6f 72 65 20 63 | 61 6c 6c 69 6e 67 20 74 |before c|alling t|
|00004310| 68 69 73 20 72 6f 75 74 | 69 6e 65 2e 0d 20 20 20 |his rout|ine..   |
|00004320| 2a 20 59 6f 75 20 6d 75 | 73 74 20 62 65 20 69 6e |* You mu|st be in|
|00004330| 73 69 64 65 20 61 6e 20 | 49 43 42 65 67 69 6e 2f |side an |ICBegin/|
|00004340| 45 6e 64 20 70 61 69 72 | 20 74 6f 20 63 61 6c 6c |End pair| to call|
|00004350| 20 74 68 69 73 20 72 6f | 75 74 69 6e 65 2e 0d 20 | this ro|utine.. |
|00004360| 20 20 2a 20 54 65 72 6d | 69 6e 61 74 65 73 20 61 |  * Term|inates a|
|00004370| 20 70 72 65 66 65 72 65 | 6e 63 65 20 73 65 73 73 | prefere|nce sess|
|00004380| 69 6f 6e 2c 20 61 73 20 | 73 74 61 72 74 65 64 20 |ion, as |started |
|00004390| 62 79 20 49 43 42 65 67 | 69 6e 2e 0d 20 20 20 2a |by ICBeg|in..   *|
|000043a0| 20 59 6f 75 20 6d 75 73 | 74 20 68 61 76 65 20 63 | You mus|t have c|
|000043b0| 61 6c 6c 65 64 20 49 43 | 42 65 67 69 6e 20 62 65 |alled IC|Begin be|
|000043c0| 66 6f 72 65 20 63 61 6c | 6c 69 6e 67 20 74 68 69 |fore cal|ling thi|
|000043d0| 73 20 72 6f 75 74 69 6e | 65 2e 0d 20 20 20 2a 2f |s routin|e..   */|
|000043e0| 0d 0d 2f 2a 20 2a 2a 2a | 2a 2a 20 55 73 65 72 20 |../* ***|** User |
|000043f0| 49 6e 74 65 72 66 61 63 | 65 20 53 74 75 66 66 20 |Interfac|e Stuff |
|00004400| 2a 2a 2a 2a 2a 20 2a 2f | 0d 0d 70 61 73 63 61 6c |***** */|..pascal|
|00004410| 20 49 43 45 72 72 6f 72 | 20 49 43 43 45 64 69 74 | ICError| ICCEdit|
|00004420| 50 72 65 66 65 72 65 6e | 63 65 73 28 69 6e 74 65 |Preferen|ces(inte|
|00004430| 72 6e 65 74 43 6f 6e 66 | 69 67 75 72 61 74 69 6f |rnetConf|iguratio|
|00004440| 6e 43 6f 6d 70 6f 6e 65 | 6e 74 20 69 6e 73 74 2c |nCompone|nt inst,|
|00004450| 20 43 6f 6e 73 74 53 74 | 72 32 35 35 50 61 72 61 | ConstSt|r255Para|
|00004460| 6d 20 6b 65 79 29 0d 46 | 49 56 45 57 4f 52 44 49 |m key).F|IVEWORDI|
|00004470| 4e 4c 49 4e 45 28 30 78 | 32 46 33 43 2c 20 34 2c |NLINE(0x|2F3C, 4,|
|00004480| 20 31 35 2c 20 30 78 37 | 30 30 30 2c 20 30 78 41 | 15, 0x7|000, 0xA|
|00004490| 38 32 41 29 3b 0d 20 20 | 2f 2a 20 52 65 71 75 69 |82A);.  |/* Requi|
|000044a0| 72 65 73 20 49 43 20 31 | 2e 31 2e 0d 20 20 20 2a |res IC 1|.1..   *|
|000044b0| 20 59 6f 75 20 6d 75 73 | 74 20 73 70 65 63 69 66 | You mus|t specif|
|000044c0| 79 20 61 20 63 6f 6e 66 | 69 67 75 72 61 74 69 6f |y a conf|iguratio|
|000044d0| 6e 20 62 65 66 6f 72 65 | 20 63 61 6c 6c 69 6e 67 |n before| calling|
|000044e0| 20 74 68 69 73 20 72 6f | 75 74 69 6e 65 2e 0d 20 | this ro|utine.. |
|000044f0| 20 20 2a 20 59 6f 75 20 | 64 6f 20 6e 6f 74 20 68 |  * You |do not h|
|00004500| 61 76 65 20 74 6f 20 62 | 65 20 69 6e 73 69 64 65 |ave to b|e inside|
|00004510| 20 61 6e 20 49 43 42 65 | 67 69 6e 2f 45 6e 64 20 | an ICBe|gin/End |
|00004520| 70 61 69 72 20 74 6f 20 | 63 61 6c 6c 20 74 68 69 |pair to |call thi|
|00004530| 73 20 72 6f 75 74 69 6e | 65 2e 0d 20 20 20 2a 20 |s routin|e..   * |
|00004540| 49 6e 73 74 72 75 63 74 | 73 20 49 43 20 74 6f 20 |Instruct|s IC to |
|00004550| 64 69 73 70 6c 61 79 20 | 74 68 65 20 75 73 65 72 |display |the user|
|00004560| 20 69 6e 74 65 72 66 61 | 63 65 20 61 73 73 6f 63 | interfa|ce assoc|
|00004570| 69 61 74 65 64 20 77 69 | 74 68 20 65 64 69 74 69 |iated wi|th editi|
|00004580| 6e 67 0d 20 20 20 2a 20 | 70 72 65 66 65 72 65 6e |ng.   * |preferen|
|00004590| 63 65 73 20 61 6e 64 20 | 66 6f 63 75 73 69 6e 67 |ces and |focusing|
|000045a0| 20 6f 6e 20 74 68 65 20 | 70 72 65 66 65 72 65 6e | on the |preferen|
|000045b0| 63 65 20 73 70 65 63 69 | 66 69 65 64 20 62 79 20 |ce speci|fied by |
|000045c0| 6b 65 79 2e 0d 20 20 20 | 2a 20 49 66 20 6b 65 79 |key..   |* If key|
|000045d0| 20 69 73 20 74 68 65 20 | 65 6d 70 74 79 20 73 74 | is the |empty st|
|000045e0| 72 69 6e 67 20 74 68 65 | 6e 20 6e 6f 20 70 72 65 |ring the|n no pre|
|000045f0| 66 65 72 65 6e 63 65 20 | 73 68 6f 75 6c 64 20 62 |ference |should b|
|00004600| 65 20 66 6f 63 75 73 65 | 64 20 75 70 6f 6e 2e 0d |e focuse|d upon..|
|00004610| 20 20 20 2a 20 59 6f 75 | 20 6d 75 73 74 20 68 61 |   * You| must ha|
|00004620| 76 65 20 73 70 65 63 69 | 66 69 65 64 20 61 20 63 |ve speci|fied a c|
|00004630| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 20 62 65 66 |onfigura|tion bef|
|00004640| 6f 72 65 20 63 61 6c 6c | 69 6e 67 20 74 68 69 73 |ore call|ing this|
|00004650| 20 72 6f 75 74 69 6e 65 | 2e 0d 20 20 20 2a 20 59 | routine|..   * Y|
|00004660| 6f 75 20 64 6f 20 6e 6f | 74 20 6e 65 65 64 20 74 |ou do no|t need t|
|00004670| 6f 20 63 61 6c 6c 20 49 | 43 42 65 67 69 6e 20 62 |o call I|CBegin b|
|00004680| 65 66 6f 72 65 20 63 61 | 6c 6c 69 6e 67 20 74 68 |efore ca|lling th|
|00004690| 69 73 20 72 6f 75 74 69 | 6e 65 2e 0d 20 20 20 2a |is routi|ne..   *|
|000046a0| 20 49 6e 20 74 68 65 20 | 63 75 72 72 65 6e 74 20 | In the |current |
|000046b0| 69 6d 70 6c 65 6d 65 6e | 74 61 74 69 6f 6e 20 74 |implemen|tation t|
|000046c0| 68 69 73 20 6c 61 75 6e | 63 68 65 73 20 74 68 65 |his laun|ches the|
|000046d0| 20 49 43 20 61 70 70 6c | 69 63 61 74 69 6f 6e 0d | IC appl|ication.|
|000046e0| 20 20 20 2a 20 28 6f 72 | 20 62 72 69 6e 67 73 20 |   * (or| brings |
|000046f0| 69 74 20 74 6f 20 74 68 | 65 20 66 72 6f 6e 74 29 |it to th|e front)|
|00004700| 20 61 6e 64 20 64 69 73 | 70 6c 61 79 73 20 74 68 | and dis|plays th|
|00004710| 65 20 77 69 6e 64 6f 77 | 20 63 6f 6e 74 61 69 6e |e window| contain|
|00004720| 69 6e 67 0d 20 20 20 2a | 20 74 68 65 20 70 72 65 |ing.   *| the pre|
|00004730| 66 65 72 65 6e 63 65 20 | 73 70 65 63 69 66 69 65 |ference |specifie|
|00004740| 64 20 62 79 20 6b 65 79 | 2e 0d 20 20 20 2a 20 49 |d by key|..   * I|
|00004750| 74 20 6d 61 79 20 68 61 | 76 65 20 61 20 72 61 64 |t may ha|ve a rad|
|00004760| 69 63 61 6c 6c 79 20 64 | 69 66 66 65 72 65 6e 74 |ically d|ifferent|
|00004770| 20 69 6d 70 6c 65 6d 65 | 6e 74 61 74 69 6f 6e 20 | impleme|ntation |
|00004780| 69 6e 20 66 75 74 75 72 | 65 0d 20 20 20 2a 20 49 |in futur|e.   * I|
|00004790| 43 20 73 79 73 74 65 6d | 73 2e 0d 20 20 20 2a 2f |C system|s..   */|
|000047a0| 0d 0d 2f 2a 20 2a 2a 2a | 2a 2a 20 55 52 4c 20 48 |../* ***|** URL H|
|000047b0| 61 6e 64 6c 69 6e 67 20 | 2a 2a 2a 2a 2a 20 2a 2f |andling |***** */|
|000047c0| 0d 0d 70 61 73 63 61 6c | 20 49 43 45 72 72 6f 72 |..pascal| ICError|
|000047d0| 20 49 43 43 50 61 72 73 | 65 55 52 4c 28 69 6e 74 | ICCPars|eURL(int|
|000047e0| 65 72 6e 65 74 43 6f 6e | 66 69 67 75 72 61 74 69 |ernetCon|figurati|
|000047f0| 6f 6e 43 6f 6d 70 6f 6e | 65 6e 74 20 69 6e 73 74 |onCompon|ent inst|
|00004800| 2c 20 43 6f 6e 73 74 53 | 74 72 32 35 35 50 61 72 |, ConstS|tr255Par|
|00004810| 61 6d 20 68 69 6e 74 2c | 20 50 74 72 20 64 61 74 |am hint,| Ptr dat|
|00004820| 61 2c 20 6c 6f 6e 67 20 | 6c 65 6e 2c 20 6c 6f 6e |a, long |len, lon|
|00004830| 67 20 2a 73 65 6c 53 74 | 61 72 74 2c 20 6c 6f 6e |g *selSt|art, lon|
|00004840| 67 20 2a 73 65 6c 45 6e | 64 2c 20 48 61 6e 64 6c |g *selEn|d, Handl|
|00004850| 65 20 75 72 6c 29 0d 46 | 49 56 45 57 4f 52 44 49 |e url).F|IVEWORDI|
|00004860| 4e 4c 49 4e 45 28 30 78 | 32 46 33 43 2c 20 32 34 |NLINE(0x|2F3C, 24|
|00004870| 2c 20 31 36 2c 20 30 78 | 37 30 30 30 2c 20 30 78 |, 16, 0x|7000, 0x|
|00004880| 41 38 32 41 29 3b 0d 20 | 20 2f 2a 20 52 65 71 75 |A82A);. | /* Requ|
|00004890| 69 72 65 73 20 49 43 20 | 31 2e 31 2e 0d 20 20 20 |ires IC |1.1..   |
|000048a0| 2a 20 59 6f 75 20 6d 75 | 73 74 20 73 70 65 63 69 |* You mu|st speci|
|000048b0| 66 79 20 61 20 63 6f 6e | 66 69 67 75 72 61 74 69 |fy a con|figurati|
|000048c0| 6f 6e 20 62 65 66 6f 72 | 65 20 63 61 6c 6c 69 6e |on befor|e callin|
|000048d0| 67 20 74 68 69 73 20 72 | 6f 75 74 69 6e 65 2e 0d |g this r|outine..|
|000048e0| 20 20 20 2a 20 59 6f 75 | 20 64 6f 20 6e 6f 74 20 |   * You| do not |
|000048f0| 68 61 76 65 20 74 6f 20 | 62 65 20 69 6e 73 69 64 |have to |be insid|
|00004900| 65 20 61 6e 20 49 43 42 | 65 67 69 6e 2f 45 6e 64 |e an ICB|egin/End|
|00004910| 20 70 61 69 72 20 74 6f | 20 63 61 6c 6c 20 74 68 | pair to| call th|
|00004920| 69 73 20 72 6f 75 74 69 | 6e 65 2e 0d 20 20 20 2a |is routi|ne..   *|
|00004930| 20 50 61 72 73 65 73 20 | 61 20 55 52 4c 20 6f 75 | Parses |a URL ou|
|00004940| 74 20 6f 66 20 74 68 65 | 20 73 70 65 63 69 66 69 |t of the| specifi|
|00004950| 65 64 20 74 65 78 74 20 | 61 6e 64 20 72 65 74 75 |ed text |and retu|
|00004960| 72 6e 73 20 69 74 20 69 | 6e 20 61 20 63 61 6e 6f |rns it i|n a cano|
|00004970| 6e 69 63 61 6c 20 66 6f | 72 6d 0d 20 20 20 2a 20 |nical fo|rm.   * |
|00004980| 69 6e 20 61 20 68 61 6e | 64 6c 65 2e 0d 20 20 20 |in a han|dle..   |
|00004990| 2a 20 68 69 6e 74 20 69 | 6e 64 69 63 61 74 65 73 |* hint i|ndicates|
|000049a0| 20 74 68 65 20 64 65 66 | 61 75 6c 74 20 73 63 68 | the def|ault sch|
|000049b0| 65 6d 65 20 66 6f 72 20 | 55 52 4c 73 20 6f 66 20 |eme for |URLs of |
|000049c0| 74 68 65 20 66 6f 72 6d | 20 22 6e 61 6d 65 40 61 |the form| "name@a|
|000049d0| 64 64 72 65 73 73 22 2e | 0d 20 20 20 2a 20 49 66 |ddress".|.   * If|
|000049e0| 20 68 69 6e 74 20 69 73 | 20 74 68 65 20 65 6d 70 | hint is| the emp|
|000049f0| 74 79 20 73 74 72 69 6e | 67 20 74 68 65 6e 20 55 |ty strin|g then U|
|00004a00| 52 4c 73 20 6f 66 20 74 | 68 61 74 20 66 6f 72 6d |RLs of t|hat form|
|00004a10| 20 61 72 65 20 6e 6f 74 | 20 61 6c 6c 6f 77 65 64 | are not| allowed|
|00004a20| 2e 0d 20 20 20 2a 20 64 | 61 74 61 20 70 6f 69 6e |..   * d|ata poin|
|00004a30| 74 73 20 74 6f 20 74 68 | 65 20 73 74 61 72 74 20 |ts to th|e start |
|00004a40| 6f 66 20 74 68 65 20 74 | 65 78 74 2e 20 49 74 20 |of the t|ext. It |
|00004a50| 6d 75 73 74 20 6e 6f 74 | 20 62 65 20 6e 69 6c 2e |must not| be nil.|
|00004a60| 0d 20 20 20 2a 20 6c 65 | 6e 20 69 6e 64 69 63 61 |.   * le|n indica|
|00004a70| 74 65 73 20 74 68 65 20 | 6c 65 6e 67 74 68 20 6f |tes the |length o|
|00004a80| 66 20 74 68 65 20 74 65 | 78 74 2e 20 49 74 20 6d |f the te|xt. It m|
|00004a90| 75 73 74 20 62 65 20 6e | 6f 6e 2d 6e 65 67 61 74 |ust be n|on-negat|
|00004aa0| 69 76 65 2e 0d 20 20 20 | 2a 20 73 65 6c 53 74 61 |ive..   |* selSta|
|00004ab0| 72 74 20 61 6e 64 20 73 | 65 6c 45 6e 64 20 73 68 |rt and s|elEnd sh|
|00004ac0| 6f 75 6c 64 20 62 65 20 | 70 61 73 73 65 64 20 69 |ould be |passed i|
|00004ad0| 6e 20 61 73 20 74 68 65 | 20 63 75 72 72 65 6e 74 |n as the| current|
|00004ae0| 20 73 65 6c 65 63 74 69 | 6f 6e 20 6f 66 0d 20 20 | selecti|on of.  |
|00004af0| 20 2a 20 74 68 65 20 74 | 65 78 74 2e 20 54 68 69 | * the t|ext. Thi|
|00004b00| 73 20 73 65 6c 65 63 74 | 69 6f 6e 20 69 73 20 67 |s select|ion is g|
|00004b10| 69 76 65 6e 20 69 6e 20 | 74 68 65 20 73 61 6d 65 |iven in |the same|
|00004b20| 20 6d 61 6e 6e 65 72 20 | 61 73 20 54 65 78 74 45 | manner |as TextE|
|00004b30| 64 69 74 2c 0d 20 20 20 | 2a 20 69 65 20 69 66 20 |dit,.   |* ie if |
|00004b40| 73 65 6c 53 74 61 72 74 | 20 3d 20 73 65 6c 45 6e |selStart| = selEn|
|00004b50| 64 20 74 68 65 6e 20 74 | 68 65 72 65 20 69 73 20 |d then t|here is |
|00004b60| 6e 6f 20 73 65 6c 65 63 | 74 69 6f 6e 20 6f 6e 6c |no selec|tion onl|
|00004b70| 79 20 61 6e 20 69 6e 73 | 65 72 74 69 6f 6e 0d 20 |y an ins|ertion. |
|00004b80| 20 20 2a 20 70 6f 69 6e | 74 2e 20 41 6c 73 6f 20 |  * poin|t. Also |
|00004b90| 73 65 6c 53 74 61 72 74 | 20 b2 20 73 65 6c 45 6e |selStart| . selEn|
|00004ba0| 64 20 61 6e 64 20 30 20 | b2 20 73 65 6c 53 74 61 |d and 0 |. selSta|
|00004bb0| 72 74 20 b2 20 6c 65 6e | 20 61 6e 64 20 30 20 b2 |rt . len| and 0 .|
|00004bc0| 20 73 65 6c 45 6e 64 20 | b2 20 6c 65 6e 2e 0d 20 | selEnd |. len.. |
|00004bd0| 20 20 2a 20 73 65 6c 53 | 74 61 72 74 20 61 6e 64 |  * selS|tart and|
|00004be0| 20 73 65 6c 45 6e 64 20 | 61 72 65 20 72 65 74 75 | selEnd |are retu|
|00004bf0| 72 6e 65 64 20 61 73 20 | 74 68 65 20 62 6f 75 6e |rned as |the boun|
|00004c00| 64 73 20 6f 66 20 74 68 | 65 20 55 52 4c 2e 20 49 |ds of th|e URL. I|
|00004c10| 66 20 74 68 65 0d 20 20 | 20 2a 20 72 6f 75 74 69 |f the.  | * routi|
|00004c20| 6e 65 20 72 65 74 75 72 | 6e 73 20 61 6e 20 65 72 |ne retur|ns an er|
|00004c30| 72 6f 72 20 74 68 65 6e | 20 74 68 65 73 65 20 6e |ror then| these n|
|00004c40| 65 77 20 62 6f 75 6e 64 | 61 72 69 65 73 20 6d 61 |ew bound|aries ma|
|00004c50| 79 20 62 65 0d 20 20 20 | 2a 20 69 6e 76 61 6c 69 |y be.   |* invali|
|00004c60| 64 20 62 75 74 20 74 68 | 65 79 20 77 69 6c 6c 20 |d but th|ey will |
|00004c70| 62 65 20 63 6c 6f 73 65 | 2e 0d 20 20 20 2a 20 54 |be close|..   * T|
|00004c80| 68 65 20 69 6e 63 6f 6d | 69 6e 67 20 75 72 6c 20 |he incom|ing url |
|00004c90| 68 61 6e 64 6c 65 20 6d | 75 73 74 20 6e 6f 74 20 |handle m|ust not |
|00004ca0| 62 65 20 6e 69 6c 2e 20 | 20 54 68 65 20 72 65 73 |be nil. | The res|
|00004cb0| 75 6c 74 69 6e 67 20 55 | 52 4c 20 69 73 20 6e 6f |ulting U|RL is no|
|00004cc0| 72 6d 61 6c 69 73 65 64 | 0d 20 20 20 2a 20 61 6e |rmalised|.   * an|
|00004cd0| 64 20 63 6f 70 69 65 64 | 20 69 6e 74 6f 20 74 68 |d copied| into th|
|00004ce0| 65 20 75 72 6c 20 68 61 | 6e 64 6c 65 2c 20 77 68 |e url ha|ndle, wh|
|00004cf0| 69 63 68 20 69 73 20 72 | 65 73 69 7a 65 64 20 74 |ich is r|esized t|
|00004d00| 6f 20 66 69 74 2e 0d 20 | 20 20 2a 2f 0d 0d 70 61 |o fit.. |  */..pa|
|00004d10| 73 63 61 6c 20 49 43 45 | 72 72 6f 72 20 49 43 43 |scal ICE|rror ICC|
|00004d20| 4c 61 75 6e 63 68 55 52 | 4c 28 69 6e 74 65 72 6e |LaunchUR|L(intern|
|00004d30| 65 74 43 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 43 |etConfig|urationC|
|00004d40| 6f 6d 70 6f 6e 65 6e 74 | 20 69 6e 73 74 2c 20 43 |omponent| inst, C|
|00004d50| 6f 6e 73 74 53 74 72 32 | 35 35 50 61 72 61 6d 20 |onstStr2|55Param |
|00004d60| 68 69 6e 74 2c 20 50 74 | 72 20 64 61 74 61 2c 20 |hint, Pt|r data, |
|00004d70| 6c 6f 6e 67 20 6c 65 6e | 2c 20 6c 6f 6e 67 20 2a |long len|, long *|
|00004d80| 73 65 6c 53 74 61 72 74 | 2c 20 6c 6f 6e 67 20 2a |selStart|, long *|
|00004d90| 73 65 6c 45 6e 64 29 0d | 46 49 56 45 57 4f 52 44 |selEnd).|FIVEWORD|
|00004da0| 49 4e 4c 49 4e 45 28 30 | 78 32 46 33 43 2c 20 32 |INLINE(0|x2F3C, 2|
|00004db0| 30 2c 20 31 37 2c 20 30 | 78 37 30 30 30 2c 20 30 |0, 17, 0|x7000, 0|
|00004dc0| 78 41 38 32 41 29 3b 0d | 20 20 2f 2a 20 52 65 71 |xA82A);.|  /* Req|
|00004dd0| 75 69 72 65 73 20 49 43 | 20 31 2e 31 2e 0d 20 20 |uires IC| 1.1..  |
|00004de0| 20 2a 20 59 6f 75 20 6d | 75 73 74 20 73 70 65 63 | * You m|ust spec|
|00004df0| 69 66 79 20 61 20 63 6f | 6e 66 69 67 75 72 61 74 |ify a co|nfigurat|
|00004e00| 69 6f 6e 20 62 65 66 6f | 72 65 20 63 61 6c 6c 69 |ion befo|re calli|
|00004e10| 6e 67 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 2e |ng this |routine.|
|00004e20| 0d 20 20 20 2a 20 59 6f | 75 20 64 6f 20 6e 6f 74 |.   * Yo|u do not|
|00004e30| 20 68 61 76 65 20 74 6f | 20 62 65 20 69 6e 73 69 | have to| be insi|
|00004e40| 64 65 20 61 6e 20 49 43 | 42 65 67 69 6e 2f 45 6e |de an IC|Begin/En|
|00004e50| 64 20 70 61 69 72 20 74 | 6f 20 63 61 6c 6c 20 74 |d pair t|o call t|
|00004e60| 68 69 73 20 72 6f 75 74 | 69 6e 65 2e 0d 20 20 20 |his rout|ine..   |
|00004e70| 2a 20 50 61 72 73 65 73 | 20 61 20 55 52 4c 20 6f |* Parses| a URL o|
|00004e80| 75 74 20 6f 66 20 74 68 | 65 20 73 70 65 63 69 66 |ut of th|e specif|
|00004e90| 69 65 64 20 74 65 78 74 | 20 61 6e 64 20 66 65 65 |ied text| and fee|
|00004ea0| 64 73 20 69 74 20 6f 66 | 66 20 74 6f 20 74 68 65 |ds it of|f to the|
|00004eb0| 0d 20 20 20 2a 20 61 70 | 70 72 6f 70 72 69 61 74 |.   * ap|propriat|
|00004ec0| 65 20 68 65 6c 70 65 72 | 2e 0d 20 20 20 2a 20 68 |e helper|..   * h|
|00004ed0| 69 6e 74 20 69 6e 64 69 | 63 61 74 65 73 20 74 68 |int indi|cates th|
|00004ee0| 65 20 64 65 66 61 75 6c | 74 20 73 63 68 65 6d 65 |e defaul|t scheme|
|00004ef0| 20 66 6f 72 20 55 52 4c | 73 20 6f 66 20 74 68 65 | for URL|s of the|
|00004f00| 20 66 6f 72 6d 20 22 6e | 61 6d 65 40 61 64 64 72 | form "n|ame@addr|
|00004f10| 65 73 73 22 2e 0d 20 20 | 20 2a 20 49 66 20 68 69 |ess"..  | * If hi|
|00004f20| 6e 74 20 69 73 20 74 68 | 65 20 65 6d 70 74 79 20 |nt is th|e empty |
|00004f30| 73 74 72 69 6e 67 20 74 | 68 65 6e 20 55 52 4c 73 |string t|hen URLs|
|00004f40| 20 6f 66 20 74 68 61 74 | 20 66 6f 72 6d 20 61 72 | of that| form ar|
|00004f50| 65 20 6e 6f 74 20 61 6c | 6c 6f 77 65 64 2e 0d 20 |e not al|lowed.. |
|00004f60| 20 20 2a 20 64 61 74 61 | 20 70 6f 69 6e 74 73 20 |  * data| points |
|00004f70| 74 6f 20 74 68 65 20 73 | 74 61 72 74 20 6f 66 20 |to the s|tart of |
|00004f80| 74 68 65 20 74 65 78 74 | 2e 20 49 74 20 6d 75 73 |the text|. It mus|
|00004f90| 74 20 6e 6f 74 20 62 65 | 20 6e 69 6c 2e 0d 20 20 |t not be| nil..  |
|00004fa0| 20 2a 20 6c 65 6e 20 69 | 6e 64 69 63 61 74 65 73 | * len i|ndicates|
|00004fb0| 20 74 68 65 20 6c 65 6e | 67 74 68 20 6f 66 20 74 | the len|gth of t|
|00004fc0| 68 65 20 74 65 78 74 2e | 20 49 74 20 6d 75 73 74 |he text.| It must|
|00004fd0| 20 62 65 20 6e 6f 6e 2d | 6e 65 67 61 74 69 76 65 | be non-|negative|
|00004fe0| 2e 0d 20 20 20 2a 20 73 | 65 6c 53 74 61 72 74 20 |..   * s|elStart |
|00004ff0| 61 6e 64 20 73 65 6c 45 | 6e 64 20 73 68 6f 75 6c |and selE|nd shoul|
|00005000| 64 20 62 65 20 70 61 73 | 73 65 64 20 69 6e 20 61 |d be pas|sed in a|
|00005010| 73 20 74 68 65 20 63 75 | 72 72 65 6e 74 20 73 65 |s the cu|rrent se|
|00005020| 6c 65 63 74 69 6f 6e 20 | 6f 66 0d 20 20 20 2a 20 |lection |of.   * |
|00005030| 74 68 65 20 74 65 78 74 | 2e 20 54 68 69 73 20 73 |the text|. This s|
|00005040| 65 6c 65 63 74 69 6f 6e | 20 69 73 20 67 69 76 65 |election| is give|
|00005050| 6e 20 69 6e 20 74 68 65 | 20 73 61 6d 65 20 6d 61 |n in the| same ma|
|00005060| 6e 6e 65 72 20 61 73 20 | 54 65 78 74 45 64 69 74 |nner as |TextEdit|
|00005070| 2c 0d 20 20 20 2a 20 69 | 65 20 69 66 20 73 65 6c |,.   * i|e if sel|
|00005080| 53 74 61 72 74 20 3d 20 | 73 65 6c 45 6e 64 20 74 |Start = |selEnd t|
|00005090| 68 65 6e 20 74 68 65 72 | 65 20 69 73 20 6e 6f 20 |hen ther|e is no |
|000050a0| 73 65 6c 65 63 74 69 6f | 6e 20 6f 6e 6c 79 20 61 |selectio|n only a|
|000050b0| 6e 20 69 6e 73 65 72 74 | 69 6f 6e 0d 20 20 20 2a |n insert|ion.   *|
|000050c0| 20 70 6f 69 6e 74 2e 20 | 41 6c 73 6f 20 73 65 6c | point. |Also sel|
|000050d0| 53 74 61 72 74 20 b2 20 | 73 65 6c 45 6e 64 20 61 |Start . |selEnd a|
|000050e0| 6e 64 20 30 20 b2 20 73 | 65 6c 53 74 61 72 74 20 |nd 0 . s|elStart |
|000050f0| b2 20 6c 65 6e 20 61 6e | 64 20 30 20 b2 20 73 65 |. len an|d 0 . se|
|00005100| 6c 45 6e 64 20 b2 20 6c | 65 6e 2e 0d 20 20 20 2a |lEnd . l|en..   *|
|00005110| 20 73 65 6c 53 74 61 72 | 74 20 61 6e 64 20 73 65 | selStar|t and se|
|00005120| 6c 45 6e 64 20 61 72 65 | 20 72 65 74 75 72 6e 65 |lEnd are| returne|
|00005130| 64 20 61 73 20 74 68 65 | 20 62 6f 75 6e 64 73 20 |d as the| bounds |
|00005140| 6f 66 20 74 68 65 20 55 | 52 4c 2e 20 49 66 20 74 |of the U|RL. If t|
|00005150| 68 65 0d 20 20 20 2a 20 | 72 6f 75 74 69 6e 65 20 |he.   * |routine |
|00005160| 72 65 74 75 72 6e 73 20 | 61 6e 20 65 72 72 6f 72 |returns |an error|
|00005170| 20 74 68 65 6e 20 74 68 | 65 73 65 20 6e 65 77 20 | then th|ese new |
|00005180| 62 6f 75 6e 64 61 72 69 | 65 73 20 6d 61 79 20 62 |boundari|es may b|
|00005190| 65 0d 20 20 20 2a 20 69 | 6e 76 61 6c 69 64 20 62 |e.   * i|nvalid b|
|000051a0| 75 74 20 74 68 65 79 20 | 77 69 6c 6c 20 62 65 20 |ut they |will be |
|000051b0| 63 6c 6f 73 65 2e 0d 20 | 20 20 2a 20 54 68 65 20 |close.. |  * The |
|000051c0| 55 52 4c 20 69 73 20 70 | 61 72 73 65 64 20 6f 75 |URL is p|arsed ou|
|000051d0| 74 20 6f 66 20 74 68 65 | 20 74 65 78 74 20 61 6e |t of the| text an|
|000051e0| 64 20 70 61 73 73 65 64 | 20 6f 66 66 20 74 6f 20 |d passed| off to |
|000051f0| 74 68 65 20 61 70 70 72 | 6f 70 72 69 61 74 65 0d |the appr|opriate.|
|00005200| 20 20 20 2a 20 68 65 6c | 70 65 72 20 75 73 69 6e |   * hel|per usin|
|00005210| 67 20 74 68 65 20 47 55 | 52 4c 20 41 70 70 6c 65 |g the GU|RL Apple|
|00005220| 45 76 65 6e 74 2e 0d 20 | 20 20 2a 2f 0d 0d 2f 2a |Event.. |  */../*|
|00005230| 20 2a 2a 2a 2a 2a 20 4d | 61 70 70 69 6e 67 73 20 | ***** M|appings |
|00005240| 52 6f 75 74 69 6e 65 73 | 20 2a 2a 2a 2a 2a 0d 20 |Routines| *****. |
|00005250| 2a 20 0d 20 2a 20 52 6f | 75 74 69 6e 65 73 20 66 |* . * Ro|utines f|
|00005260| 6f 72 20 69 6e 74 65 72 | 72 6f 67 61 74 69 6e 67 |or inter|rogating|
|00005270| 20 6d 61 70 70 69 6e 67 | 73 20 64 61 74 61 62 61 | mapping|s databa|
|00005280| 73 65 2e 0d 20 2a 20 0d | 20 2a 20 2d 2d 2d 2d 2d |se.. * .| * -----|
|00005290| 20 48 69 67 68 20 4c 65 | 76 65 6c 20 52 6f 75 74 | High Le|vel Rout|
|000052a0| 69 6e 65 73 20 2d 2d 2d | 2d 2d 0d 20 2a 2f 0d 0d |ines ---|--. */..|
|000052b0| 70 61 73 63 61 6c 20 49 | 43 45 72 72 6f 72 20 49 |pascal I|CError I|
|000052c0| 43 43 4d 61 70 46 69 6c | 65 6e 61 6d 65 28 69 6e |CCMapFil|ename(in|
|000052d0| 74 65 72 6e 65 74 43 6f | 6e 66 69 67 75 72 61 74 |ternetCo|nfigurat|
|000052e0| 69 6f 6e 43 6f 6d 70 6f | 6e 65 6e 74 20 69 6e 73 |ionCompo|nent ins|
|000052f0| 74 2c 20 43 6f 6e 73 74 | 53 74 72 32 35 35 50 61 |t, Const|Str255Pa|
|00005300| 72 61 6d 20 66 69 6c 65 | 6e 61 6d 65 2c 20 49 43 |ram file|name, IC|
|00005310| 4d 61 70 45 6e 74 72 79 | 20 2a 65 6e 74 72 79 29 |MapEntry| *entry)|
|00005320| 0d 46 49 56 45 57 4f 52 | 44 49 4e 4c 49 4e 45 28 |.FIVEWOR|DINLINE(|
|00005330| 30 78 32 46 33 43 2c 20 | 38 2c 20 32 34 2c 20 30 |0x2F3C, |8, 24, 0|
|00005340| 78 37 30 30 30 2c 20 30 | 78 41 38 32 41 29 3b 0d |x7000, 0|xA82A);.|
|00005350| 20 20 2f 2a 20 52 65 71 | 75 69 72 65 73 20 49 43 |  /* Req|uires IC|
|00005360| 20 31 2e 31 2e 0d 20 20 | 20 2a 20 59 6f 75 20 6d | 1.1..  | * You m|
|00005370| 75 73 74 20 73 70 65 63 | 69 66 79 20 61 20 63 6f |ust spec|ify a co|
|00005380| 6e 66 69 67 75 72 61 74 | 69 6f 6e 20 62 65 66 6f |nfigurat|ion befo|
|00005390| 72 65 20 63 61 6c 6c 69 | 6e 67 20 74 68 69 73 20 |re calli|ng this |
|000053a0| 72 6f 75 74 69 6e 65 2e | 0d 20 20 20 2a 20 49 66 |routine.|.   * If|
|000053b0| 20 79 6f 75 20 61 72 65 | 20 67 65 74 74 69 6e 67 | you are| getting|
|000053c0| 20 6f 72 20 73 65 74 74 | 69 6e 67 20 6d 75 6c 74 | or sett|ing mult|
|000053d0| 69 70 6c 65 20 70 72 65 | 66 65 72 65 6e 63 65 73 |iple pre|ferences|
|000053e0| 2c 20 79 6f 75 20 73 68 | 6f 75 6c 64 20 70 6c 61 |, you sh|ould pla|
|000053f0| 63 65 0d 20 20 20 2a 20 | 74 68 65 73 65 20 63 61 |ce.   * |these ca|
|00005400| 6c 6c 73 20 77 69 74 68 | 69 6e 20 61 6e 20 49 43 |lls with|in an IC|
|00005410| 42 65 67 69 6e 2f 49 43 | 45 6e 64 20 70 61 69 72 |Begin/IC|End pair|
|00005420| 2e 0d 20 20 20 2a 20 49 | 66 20 79 6f 75 20 63 61 |..   * I|f you ca|
|00005430| 6c 6c 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 20 |ll this |routine |
|00005440| 6f 75 74 73 69 64 65 20 | 6f 66 20 73 75 63 68 20 |outside |of such |
|00005450| 61 20 70 61 69 72 2c 20 | 69 74 20 69 6d 70 6c 69 |a pair, |it impli|
|00005460| 63 69 74 6c 79 0d 20 20 | 20 2a 20 63 61 6c 6c 73 |citly.  | * calls|
|00005470| 20 49 43 42 65 67 69 6e | 28 69 6e 73 74 2c 20 69 | ICBegin|(inst, i|
|00005480| 63 52 65 61 64 57 72 69 | 74 65 50 65 72 6d 29 2e |cReadWri|tePerm).|
|00005490| 0d 20 20 20 2a 20 54 61 | 6b 65 73 20 74 68 65 20 |.   * Ta|kes the |
|000054a0| 6e 61 6d 65 20 6f 66 20 | 61 6e 20 69 6e 63 6f 6d |name of |an incom|
|000054b0| 69 6e 67 20 66 69 6c 65 | 20 61 6e 64 20 72 65 74 |ing file| and ret|
|000054c0| 75 72 6e 73 20 74 68 65 | 20 6d 6f 73 74 20 61 70 |urns the| most ap|
|000054d0| 70 72 6f 70 72 69 61 74 | 65 0d 20 20 20 2a 20 6d |propriat|e.   * m|
|000054e0| 61 70 70 69 6e 67 73 20 | 64 61 74 61 62 61 73 65 |appings |database|
|000054f0| 20 65 6e 74 72 79 2c 20 | 62 61 73 65 64 20 6f 6e | entry, |based on|
|00005500| 20 69 74 73 20 65 78 74 | 65 6e 73 69 6f 6e 2e 0d | its ext|ension..|
|00005510| 20 20 20 2a 20 66 69 6c | 65 6e 61 6d 65 20 6d 75 |   * fil|ename mu|
|00005520| 73 74 20 6e 6f 74 20 62 | 65 20 74 68 65 20 65 6d |st not b|e the em|
|00005530| 70 74 79 20 73 74 72 69 | 6e 67 2e 0d 20 20 20 2a |pty stri|ng..   *|
|00005540| 20 52 65 74 75 72 6e 73 | 20 69 63 50 72 65 66 4e | Returns| icPrefN|
|00005550| 6f 74 46 6f 75 6e 64 45 | 72 72 20 69 66 20 6e 6f |otFoundE|rr if no|
|00005560| 20 73 75 69 74 61 62 6c | 65 20 65 6e 74 72 79 20 | suitabl|e entry |
|00005570| 69 73 20 66 6f 75 6e 64 | 2e 0d 20 20 20 2a 2f 0d |is found|..   */.|
|00005580| 0d 70 61 73 63 61 6c 20 | 49 43 45 72 72 6f 72 20 |.pascal |ICError |
|00005590| 49 43 43 4d 61 70 54 79 | 70 65 43 72 65 61 74 6f |ICCMapTy|peCreato|
|000055a0| 72 28 69 6e 74 65 72 6e | 65 74 43 6f 6e 66 69 67 |r(intern|etConfig|
|000055b0| 75 72 61 74 69 6f 6e 43 | 6f 6d 70 6f 6e 65 6e 74 |urationC|omponent|
|000055c0| 20 69 6e 73 74 2c 20 4f | 53 54 79 70 65 20 66 54 | inst, O|SType fT|
|000055d0| 79 70 65 2c 20 4f 53 54 | 79 70 65 20 66 43 72 65 |ype, OST|ype fCre|
|000055e0| 61 74 6f 72 2c 20 43 6f | 6e 73 74 53 74 72 32 35 |ator, Co|nstStr25|
|000055f0| 35 50 61 72 61 6d 20 66 | 69 6c 65 6e 61 6d 65 2c |5Param f|ilename,|
|00005600| 20 49 43 4d 61 70 45 6e | 74 72 79 20 2a 65 6e 74 | ICMapEn|try *ent|
|00005610| 72 79 29 0d 46 49 56 45 | 57 4f 52 44 49 4e 4c 49 |ry).FIVE|WORDINLI|
|00005620| 4e 45 28 30 78 32 46 33 | 43 2c 20 31 36 2c 20 32 |NE(0x2F3|C, 16, 2|
|00005630| 35 2c 20 30 78 37 30 30 | 30 2c 20 30 78 41 38 32 |5, 0x700|0, 0xA82|
|00005640| 41 29 3b 0d 20 20 2f 2a | 20 52 65 71 75 69 72 65 |A);.  /*| Require|
|00005650| 73 20 49 43 20 31 2e 31 | 2e 0d 20 20 20 2a 20 59 |s IC 1.1|..   * Y|
|00005660| 6f 75 20 6d 75 73 74 20 | 73 70 65 63 69 66 79 20 |ou must |specify |
|00005670| 61 20 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 20 |a config|uration |
|00005680| 62 65 66 6f 72 65 20 63 | 61 6c 6c 69 6e 67 20 74 |before c|alling t|
|00005690| 68 69 73 20 72 6f 75 74 | 69 6e 65 2e 0d 20 20 20 |his rout|ine..   |
|000056a0| 2a 20 59 6f 75 20 6d 75 | 73 74 20 62 65 20 69 6e |* You mu|st be in|
|000056b0| 73 69 64 65 20 61 6e 20 | 49 43 42 65 67 69 6e 2f |side an |ICBegin/|
|000056c0| 45 6e 64 20 70 61 69 72 | 20 74 6f 20 63 61 6c 6c |End pair| to call|
|000056d0| 20 74 68 69 73 20 72 6f | 75 74 69 6e 65 2e 0d 20 | this ro|utine.. |
|000056e0| 20 20 2a 20 54 61 6b 65 | 73 20 74 68 65 20 74 79 |  * Take|s the ty|
|000056f0| 70 65 20 61 6e 64 20 63 | 72 65 61 74 6f 72 20 28 |pe and c|reator (|
|00005700| 61 6e 64 20 6f 70 74 69 | 6f 6e 61 6c 6c 79 20 74 |and opti|onally t|
|00005710| 68 65 20 6e 61 6d 65 29 | 20 6f 66 20 61 6e 20 6f |he name)| of an o|
|00005720| 75 74 67 6f 69 6e 67 0d | 20 20 20 2a 20 66 69 6c |utgoing.|   * fil|
|00005730| 65 20 61 6e 64 20 72 65 | 74 75 72 6e 73 20 74 68 |e and re|turns th|
|00005740| 65 20 6d 6f 73 74 20 61 | 70 70 72 6f 70 72 69 61 |e most a|ppropria|
|00005750| 74 65 20 6d 61 70 70 69 | 6e 67 73 20 64 61 74 61 |te mappi|ngs data|
|00005760| 62 61 73 65 20 65 6e 74 | 72 79 2e 0d 20 20 20 2a |base ent|ry..   *|
|00005770| 20 54 68 65 20 66 69 6c | 65 6e 61 6d 65 20 6d 61 | The fil|ename ma|
|00005780| 79 20 62 65 20 65 69 74 | 68 65 72 20 74 68 65 20 |y be eit|her the |
|00005790| 6e 61 6d 65 20 6f 66 20 | 74 68 65 20 6f 75 74 67 |name of |the outg|
|000057a0| 6f 69 6e 67 20 66 69 6c | 65 20 6f 72 0d 20 20 20 |oing fil|e or.   |
|000057b0| 2a 20 74 68 65 20 65 6d | 70 74 79 20 73 74 72 69 |* the em|pty stri|
|000057c0| 6e 67 2e 0d 20 20 20 2a | 20 52 65 74 75 72 6e 73 |ng..   *| Returns|
|000057d0| 20 69 63 50 72 65 66 4e | 6f 74 46 6f 75 6e 64 45 | icPrefN|otFoundE|
|000057e0| 72 72 20 69 66 20 6e 6f | 20 73 75 69 74 61 62 6c |rr if no| suitabl|
|000057f0| 65 20 65 6e 74 72 79 20 | 66 6f 75 6e 64 2e 0d 20 |e entry |found.. |
|00005800| 20 20 2a 2f 0d 0d 2f 2a | 20 2d 2d 2d 2d 2d 20 4d |  */../*| ----- M|
|00005810| 69 64 20 4c 65 76 65 6c | 20 52 6f 75 74 69 6e 65 |id Level| Routine|
|00005820| 73 20 2d 2d 2d 2d 2d 20 | 2a 2f 0d 0d 70 61 73 63 |s ----- |*/..pasc|
|00005830| 61 6c 20 49 43 45 72 72 | 6f 72 20 49 43 43 4d 61 |al ICErr|or ICCMa|
|00005840| 70 45 6e 74 72 69 65 73 | 46 69 6c 65 6e 61 6d 65 |pEntries|Filename|
|00005850| 28 69 6e 74 65 72 6e 65 | 74 43 6f 6e 66 69 67 75 |(interne|tConfigu|
|00005860| 72 61 74 69 6f 6e 43 6f | 6d 70 6f 6e 65 6e 74 20 |rationCo|mponent |
|00005870| 69 6e 73 74 2c 20 48 61 | 6e 64 6c 65 20 65 6e 74 |inst, Ha|ndle ent|
|00005880| 72 69 65 73 2c 20 43 6f | 6e 73 74 53 74 72 32 35 |ries, Co|nstStr25|
|00005890| 35 50 61 72 61 6d 20 66 | 69 6c 65 6e 61 6d 65 2c |5Param f|ilename,|
|000058a0| 20 49 43 4d 61 70 45 6e | 74 72 79 20 2a 65 6e 74 | ICMapEn|try *ent|
|000058b0| 72 79 29 0d 46 49 56 45 | 57 4f 52 44 49 4e 4c 49 |ry).FIVE|WORDINLI|
|000058c0| 4e 45 28 30 78 32 46 33 | 43 2c 20 31 32 2c 20 32 |NE(0x2F3|C, 12, 2|
|000058d0| 38 2c 20 30 78 37 30 30 | 30 2c 20 30 78 41 38 32 |8, 0x700|0, 0xA82|
|000058e0| 41 29 3b 0d 20 20 2f 2a | 20 52 65 71 75 69 72 65 |A);.  /*| Require|
|000058f0| 73 20 49 43 20 31 2e 31 | 2e 0d 20 20 20 2a 20 59 |s IC 1.1|..   * Y|
|00005900| 6f 75 20 6d 75 73 74 20 | 73 70 65 63 69 66 79 20 |ou must |specify |
|00005910| 61 20 63 6f 6e 66 69 67 | 75 72 61 74 69 6f 6e 20 |a config|uration |
|00005920| 62 65 66 6f 72 65 20 63 | 61 6c 6c 69 6e 67 20 74 |before c|alling t|
|00005930| 68 69 73 20 72 6f 75 74 | 69 6e 65 2e 0d 20 20 20 |his rout|ine..   |
|00005940| 2a 20 59 6f 75 20 64 6f | 20 6e 6f 74 20 68 61 76 |* You do| not hav|
|00005950| 65 20 74 6f 20 62 65 20 | 69 6e 73 69 64 65 20 61 |e to be |inside a|
|00005960| 6e 20 49 43 42 65 67 69 | 6e 2f 45 6e 64 20 70 61 |n ICBegi|n/End pa|
|00005970| 69 72 20 74 6f 20 63 61 | 6c 6c 20 74 68 69 73 20 |ir to ca|ll this |
|00005980| 72 6f 75 74 69 6e 65 2e | 0d 20 20 20 2a 20 54 61 |routine.|.   * Ta|
|00005990| 6b 65 73 20 74 68 65 20 | 6e 61 6d 65 20 6f 66 20 |kes the |name of |
|000059a0| 61 6e 20 69 6e 63 6f 6d | 69 6e 67 20 66 69 6c 65 |an incom|ing file|
|000059b0| 20 61 6e 64 20 72 65 74 | 75 72 6e 73 20 74 68 65 | and ret|urns the|
|000059c0| 20 6d 6f 73 74 20 61 70 | 70 72 6f 70 72 69 61 74 | most ap|propriat|
|000059d0| 65 0d 20 20 20 2a 20 6d | 61 70 70 69 6e 67 73 20 |e.   * m|appings |
|000059e0| 64 61 74 61 62 61 73 65 | 20 65 6e 74 72 79 2c 20 |database| entry, |
|000059f0| 62 61 73 65 64 20 6f 6e | 20 69 74 73 20 65 78 74 |based on| its ext|
|00005a00| 65 6e 73 69 6f 6e 2e 0d | 20 20 20 2a 20 65 6e 74 |ension..|   * ent|
|00005a10| 72 69 65 73 20 6d 75 73 | 74 20 62 65 20 61 20 68 |ries mus|t be a h|
|00005a20| 61 6e 64 6c 65 20 74 6f | 20 61 20 76 61 6c 69 64 |andle to| a valid|
|00005a30| 20 49 43 20 6d 61 70 70 | 69 6e 67 73 20 64 61 74 | IC mapp|ings dat|
|00005a40| 61 62 61 73 65 20 70 72 | 65 66 65 72 65 6e 63 65 |abase pr|eference|
|00005a50| 2e 0d 20 20 20 2a 20 66 | 69 6c 65 6e 61 6d 65 20 |..   * f|ilename |
|00005a60| 6d 75 73 74 20 6e 6f 74 | 20 62 65 20 74 68 65 20 |must not| be the |
|00005a70| 65 6d 70 74 79 20 73 74 | 72 69 6e 67 2e 0d 20 20 |empty st|ring..  |
|00005a80| 20 2a 20 52 65 74 75 72 | 6e 73 20 69 63 50 72 65 | * Retur|ns icPre|
|00005a90| 66 4e 6f 74 46 6f 75 6e | 64 45 72 72 20 69 66 20 |fNotFoun|dErr if |
|00005aa0| 6e 6f 20 73 75 69 74 61 | 62 6c 65 20 65 6e 74 72 |no suita|ble entr|
|00005ab0| 79 20 69 73 20 66 6f 75 | 6e 64 2e 0d 20 20 20 2a |y is fou|nd..   *|
|00005ac0| 2f 0d 0d 70 61 73 63 61 | 6c 20 49 43 45 72 72 6f |/..pasca|l ICErro|
|00005ad0| 72 20 49 43 43 4d 61 70 | 45 6e 74 72 69 65 73 54 |r ICCMap|EntriesT|
|00005ae0| 79 70 65 43 72 65 61 74 | 6f 72 28 69 6e 74 65 72 |ypeCreat|or(inter|
|00005af0| 6e 65 74 43 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e |netConfi|guration|
|00005b00| 43 6f 6d 70 6f 6e 65 6e | 74 20 69 6e 73 74 2c 20 |Componen|t inst, |
|00005b10| 48 61 6e 64 6c 65 20 65 | 6e 74 72 69 65 73 2c 20 |Handle e|ntries, |
|00005b20| 4f 53 54 79 70 65 20 66 | 54 79 70 65 2c 20 4f 53 |OSType f|Type, OS|
|00005b30| 54 79 70 65 20 66 43 72 | 65 61 74 6f 72 2c 20 43 |Type fCr|eator, C|
|00005b40| 6f 6e 73 74 53 74 72 32 | 35 35 50 61 72 61 6d 20 |onstStr2|55Param |
|00005b50| 66 69 6c 65 6e 61 6d 65 | 2c 20 49 43 4d 61 70 45 |filename|, ICMapE|
|00005b60| 6e 74 72 79 20 2a 65 6e | 74 72 79 29 0d 46 49 56 |ntry *en|try).FIV|
|00005b70| 45 57 4f 52 44 49 4e 4c | 49 4e 45 28 30 78 32 46 |EWORDINL|INE(0x2F|
|00005b80| 33 43 2c 20 32 30 2c 20 | 32 39 2c 20 30 78 37 30 |3C, 20, |29, 0x70|
|00005b90| 30 30 2c 20 30 78 41 38 | 32 41 29 3b 0d 20 20 2f |00, 0xA8|2A);.  /|
|00005ba0| 2a 20 52 65 71 75 69 72 | 65 73 20 49 43 20 31 2e |* Requir|es IC 1.|
|00005bb0| 31 2e 0d 20 20 20 2a 20 | 59 6f 75 20 6d 75 73 74 |1..   * |You must|
|00005bc0| 20 73 70 65 63 69 66 79 | 20 61 20 63 6f 6e 66 69 | specify| a confi|
|00005bd0| 67 75 72 61 74 69 6f 6e | 20 62 65 66 6f 72 65 20 |guration| before |
|00005be0| 63 61 6c 6c 69 6e 67 20 | 74 68 69 73 20 72 6f 75 |calling |this rou|
|00005bf0| 74 69 6e 65 2e 0d 20 20 | 20 2a 20 59 6f 75 20 64 |tine..  | * You d|
|00005c00| 6f 20 6e 6f 74 20 68 61 | 76 65 20 74 6f 20 62 65 |o not ha|ve to be|
|00005c10| 20 69 6e 73 69 64 65 20 | 61 6e 20 49 43 42 65 67 | inside |an ICBeg|
|00005c20| 69 6e 2f 45 6e 64 20 70 | 61 69 72 20 74 6f 20 63 |in/End p|air to c|
|00005c30| 61 6c 6c 20 74 68 69 73 | 20 72 6f 75 74 69 6e 65 |all this| routine|
|00005c40| 2e 0d 20 20 20 2a 20 54 | 61 6b 65 73 20 74 68 65 |..   * T|akes the|
|00005c50| 20 74 79 70 65 20 61 6e | 64 20 63 72 65 61 74 6f | type an|d creato|
|00005c60| 72 20 28 61 6e 64 20 6f | 70 74 69 6f 6e 61 6c 6c |r (and o|ptionall|
|00005c70| 79 20 74 68 65 20 6e 61 | 6d 65 29 20 6f 66 20 61 |y the na|me) of a|
|00005c80| 6e 20 6f 75 74 67 6f 69 | 6e 67 0d 20 20 20 2a 20 |n outgoi|ng.   * |
|00005c90| 66 69 6c 65 20 61 6e 64 | 20 72 65 74 75 72 6e 73 |file and| returns|
|00005ca0| 20 74 68 65 20 6d 6f 73 | 74 20 61 70 70 72 6f 70 | the mos|t approp|
|00005cb0| 72 69 61 74 65 20 6d 61 | 70 70 69 6e 67 73 20 64 |riate ma|ppings d|
|00005cc0| 61 74 61 62 61 73 65 20 | 65 6e 74 72 79 2e 0d 20 |atabase |entry.. |
|00005cd0| 20 20 2a 20 65 6e 74 72 | 69 65 73 20 6d 75 73 74 |  * entr|ies must|
|00005ce0| 20 62 65 20 61 20 68 61 | 6e 64 6c 65 20 74 6f 20 | be a ha|ndle to |
|00005cf0| 61 20 76 61 6c 69 64 20 | 49 43 20 6d 61 70 70 69 |a valid |IC mappi|
|00005d00| 6e 67 73 20 64 61 74 61 | 62 61 73 65 20 70 72 65 |ngs data|base pre|
|00005d10| 66 65 72 65 6e 63 65 2e | 0d 20 20 20 2a 20 54 68 |ference.|.   * Th|
|00005d20| 65 20 66 69 6c 65 6e 61 | 6d 65 20 6d 61 79 20 62 |e filena|me may b|
|00005d30| 65 20 65 69 74 68 65 72 | 20 74 68 65 20 6e 61 6d |e either| the nam|
|00005d40| 65 20 6f 66 20 74 68 65 | 20 6f 75 74 67 6f 69 6e |e of the| outgoin|
|00005d50| 67 20 66 69 6c 65 20 6f | 72 0d 20 20 20 2a 20 74 |g file o|r.   * t|
|00005d60| 68 65 20 65 6d 70 74 79 | 20 73 74 72 69 6e 67 2e |he empty| string.|
|00005d70| 0d 20 20 20 2a 20 52 65 | 74 75 72 6e 73 20 69 63 |.   * Re|turns ic|
|00005d80| 50 72 65 66 4e 6f 74 46 | 6f 75 6e 64 45 72 72 20 |PrefNotF|oundErr |
|00005d90| 69 66 20 6e 6f 20 73 75 | 69 74 61 62 6c 65 20 65 |if no su|itable e|
|00005da0| 6e 74 72 79 20 66 6f 75 | 6e 64 2e 0d 20 20 20 2a |ntry fou|nd..   *|
|00005db0| 2f 0d 0d 2f 2a 20 2d 2d | 2d 2d 2d 20 4c 6f 77 20 |/../* --|--- Low |
|00005dc0| 4c 65 76 65 6c 20 52 6f | 75 74 69 6e 65 73 20 2d |Level Ro|utines -|
|00005dd0| 2d 2d 2d 2d 20 2a 2f 0d | 0d 70 61 73 63 61 6c 20 |---- */.|.pascal |
|00005de0| 49 43 45 72 72 6f 72 20 | 49 43 43 43 6f 75 6e 74 |ICError |ICCCount|
|00005df0| 4d 61 70 45 6e 74 72 69 | 65 73 28 69 6e 74 65 72 |MapEntri|es(inter|
|00005e00| 6e 65 74 43 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e |netConfi|guration|
|00005e10| 43 6f 6d 70 6f 6e 65 6e | 74 20 69 6e 73 74 2c 20 |Componen|t inst, |
|00005e20| 48 61 6e 64 6c 65 20 65 | 6e 74 72 69 65 73 2c 20 |Handle e|ntries, |
|00005e30| 6c 6f 6e 67 20 2a 63 6f | 75 6e 74 29 0d 46 49 56 |long *co|unt).FIV|
|00005e40| 45 57 4f 52 44 49 4e 4c | 49 4e 45 28 30 78 32 46 |EWORDINL|INE(0x2F|
|00005e50| 33 43 2c 20 38 2c 20 31 | 38 2c 20 30 78 37 30 30 |3C, 8, 1|8, 0x700|
|00005e60| 30 2c 20 30 78 41 38 32 | 41 29 3b 0d 20 20 2f 2a |0, 0xA82|A);.  /*|
|00005e70| 20 52 65 71 75 69 72 65 | 73 20 49 43 20 31 2e 31 | Require|s IC 1.1|
|00005e80| 2e 0d 20 20 20 2a 20 59 | 6f 75 20 6d 75 73 74 20 |..   * Y|ou must |
|00005e90| 73 70 65 63 69 66 79 20 | 61 20 63 6f 6e 66 69 67 |specify |a config|
|00005ea0| 75 72 61 74 69 6f 6e 20 | 62 65 66 6f 72 65 20 63 |uration |before c|
|00005eb0| 61 6c 6c 69 6e 67 20 74 | 68 69 73 20 72 6f 75 74 |alling t|his rout|
|00005ec0| 69 6e 65 2e 0d 20 20 20 | 2a 20 59 6f 75 20 64 6f |ine..   |* You do|
|00005ed0| 20 6e 6f 74 20 68 61 76 | 65 20 74 6f 20 62 65 20 | not hav|e to be |
|00005ee0| 69 6e 73 69 64 65 20 61 | 6e 20 49 43 42 65 67 69 |inside a|n ICBegi|
|00005ef0| 6e 2f 45 6e 64 20 70 61 | 69 72 20 74 6f 20 63 61 |n/End pa|ir to ca|
|00005f00| 6c 6c 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 2e |ll this |routine.|
|00005f10| 0d 20 20 20 2a 20 43 6f | 75 6e 74 73 20 74 68 65 |.   * Co|unts the|
|00005f20| 20 6e 75 6d 62 65 72 20 | 6f 66 20 65 6e 74 72 69 | number |of entri|
|00005f30| 65 73 20 69 6e 20 74 68 | 65 20 6d 61 70 70 69 6e |es in th|e mappin|
|00005f40| 67 73 20 64 61 74 61 62 | 61 73 65 2e 0d 20 20 20 |gs datab|ase..   |
|00005f50| 2a 20 65 6e 74 72 69 65 | 73 20 6d 75 73 74 20 62 |* entrie|s must b|
|00005f60| 65 20 61 20 68 61 6e 64 | 6c 65 20 74 6f 20 61 20 |e a hand|le to a |
|00005f70| 76 61 6c 69 64 20 49 43 | 20 6d 61 70 70 69 6e 67 |valid IC| mapping|
|00005f80| 73 20 64 61 74 61 62 61 | 73 65 20 70 72 65 66 65 |s databa|se prefe|
|00005f90| 72 65 6e 63 65 2e 0d 20 | 20 20 2a 20 63 6f 75 6e |rence.. |  * coun|
|00005fa0| 74 20 69 73 20 73 65 74 | 20 74 6f 20 74 68 65 20 |t is set| to the |
|00005fb0| 6e 75 6d 62 65 72 20 6f | 66 20 65 6e 74 72 69 65 |number o|f entrie|
|00005fc0| 73 2e 0d 20 20 20 2a 2f | 0d 0d 70 61 73 63 61 6c |s..   */|..pascal|
|00005fd0| 20 49 43 45 72 72 6f 72 | 20 49 43 43 47 65 74 49 | ICError| ICCGetI|
|00005fe0| 6e 64 4d 61 70 45 6e 74 | 72 79 28 69 6e 74 65 72 |ndMapEnt|ry(inter|
|00005ff0| 6e 65 74 43 6f 6e 66 69 | 67 75 72 61 74 69 6f 6e |netConfi|guration|
|00006000| 43 6f 6d 70 6f 6e 65 6e | 74 20 69 6e 73 74 2c 20 |Componen|t inst, |
|00006010| 48 61 6e 64 6c 65 20 65 | 6e 74 72 69 65 73 2c 20 |Handle e|ntries, |
|00006020| 6c 6f 6e 67 20 6e 64 78 | 2c 20 6c 6f 6e 67 20 2a |long ndx|, long *|
|00006030| 70 6f 73 2c 20 49 43 4d | 61 70 45 6e 74 72 79 20 |pos, ICM|apEntry |
|00006040| 2a 65 6e 74 72 79 29 0d | 46 49 56 45 57 4f 52 44 |*entry).|FIVEWORD|
|00006050| 49 4e 4c 49 4e 45 28 30 | 78 32 46 33 43 2c 20 31 |INLINE(0|x2F3C, 1|
|00006060| 36 2c 20 31 39 2c 20 30 | 78 37 30 30 30 2c 20 30 |6, 19, 0|x7000, 0|
|00006070| 78 41 38 32 41 29 3b 0d | 20 20 2f 2a 20 52 65 71 |xA82A);.|  /* Req|
|00006080| 75 69 72 65 73 20 49 43 | 20 31 2e 31 2e 0d 20 20 |uires IC| 1.1..  |
|00006090| 20 2a 20 59 6f 75 20 6d | 75 73 74 20 73 70 65 63 | * You m|ust spec|
|000060a0| 69 66 79 20 61 20 63 6f | 6e 66 69 67 75 72 61 74 |ify a co|nfigurat|
|000060b0| 69 6f 6e 20 62 65 66 6f | 72 65 20 63 61 6c 6c 69 |ion befo|re calli|
|000060c0| 6e 67 20 74 68 69 73 20 | 72 6f 75 74 69 6e 65 2e |ng this |routine.|
|000060d0| 0d 20 20 20 2a 20 59 6f | 75 20 64 6f 20 6e 6f 74 |.   * Yo|u do not|
|000060e0| 20 68 61 76 65 20 74 6f | 20 62 65 20 69 6e 73 69 | have to| be insi|
|000060f0| 64 65 20 61 6e 20 49 43 | 42 65 67 69 6e 2f 45 6e |de an IC|Begin/En|
|00006100| 64 20 70 61 69 72 20 74 | 6f 20 63 61 6c 6c 20 74 |d pair t|o call t|
|00006110| 68 69 73 20 72 6f 75 74 | 69 6e 65 2e 0d 20 20 20 |his rout|ine..   |
|00006120| 2a 20 47 65 74 73 20 74 | 68 65 20 6e 64 78 27 74 |* Gets t|he ndx't|
|00006130| 68 20 65 6e 74 72 79 20 | 69 6e 20 74 68 65 20 6d |h entry |in the m|
|00006140| 61 70 70 69 6e 67 73 20 | 64 61 74 61 62 61 73 65 |appings |database|
|00006150| 2e 0d 20 20 20 2a 20 65 | 6e 74 72 69 65 73 20 6d |..   * e|ntries m|
|00006160| 75 73 74 20 62 65 20 61 | 20 68 61 6e 64 6c 65 20 |ust be a| handle |
|00006170| 74 6f 20 61 20 76 61 6c | 69 64 20 49 43 20 6d 61 |to a val|id IC ma|
|00006180| 70 70 69 6e 67 73 20 64 | 61 74 61 62 61 73 65 20 |ppings d|atabase |
|00006190| 70 72 65 66 65 72 65 6e | 63 65 2e 0d 20 20 20 2a |preferen|ce..   *|
|000061a0| 20 6e 64 78 20 6d 75 73 | 74 20 62 65 20 69 6e 20 | ndx mus|t be in |
|000061b0| 74 68 65 20 72 61 6e 67 | 65 20 66 72 6f 6d 20 31 |the rang|e from 1|
|000061c0| 20 74 6f 20 74 68 65 20 | 6e 75 6d 62 65 72 20 6f | to the |number o|
|000061d0| 66 20 65 6e 74 72 69 65 | 73 20 69 6e 20 74 68 65 |f entrie|s in the|
|000061e0| 20 64 61 74 61 62 61 73 | 65 2e 0d 20 20 20 2a 20 | databas|e..   * |
|000061f0| 54 68 65 20 76 61 6c 75 | 65 20 6f 66 20 70 6f 73 |The valu|e of pos|
|00006200| 20 69 73 20 69 67 6e 6f | 72 65 64 20 6f 6e 20 69 | is igno|red on i|
|00006210| 6e 70 75 74 2e 20 70 6f | 73 20 69 73 20 73 65 74 |nput. po|s is set|
|00006220| 20 74 6f 20 74 68 65 20 | 70 6f 73 69 74 69 6f 6e | to the |position|
|00006230| 20 6f 66 0d 20 20 20 2a | 20 74 68 65 20 6e 64 78 | of.   *| the ndx|
|00006240| 27 74 68 20 65 6e 74 72 | 79 20 69 6e 20 74 68 65 |'th entr|y in the|
|00006250| 20 64 61 74 61 62 61 73 | 65 20 61 6e 64 20 69 73 | databas|e and is|
|00006260| 20 73 75 69 74 61 62 6c | 65 20 66 6f 72 20 70 61 | suitabl|e for pa|
|00006270| 73 73 69 6e 67 20 62 61 | 63 6b 0d 20 20 20 2a 20 |ssing ba|ck.   * |
|00006280| 69 6e 74 6f 20 49 43 53 | 65 74 4d 61 70 45 6e 74 |into ICS|etMapEnt|
|00006290| 72 79 2e 0d 20 20 20 2a | 20 44 6f 65 73 20 6e 6f |ry..   *| Does no|
|000062a0| 74 20 72 65 74 75 72 6e | 20 61 6e 79 20 75 73 65 |t return| any use|
|000062b0| 72 20 64 61 74 61 20 61 | 73 73 6f 63 69 61 74 65 |r data a|ssociate|
|000062c0| 64 20 77 69 74 68 20 74 | 68 65 20 65 6e 74 72 79 |d with t|he entry|
|000062d0| 2e 0d 20 20 20 2a 2f 0d | 0d 70 61 73 63 61 6c 20 |..   */.|.pascal |
|000062e0| 49 43 45 72 72 6f 72 20 | 49 43 43 47 65 74 4d 61 |ICError |ICCGetMa|
|000062f0| 70 45 6e 74 72 79 28 69 | 6e 74 65 72 6e 65 74 43 |pEntry(i|nternetC|
|00006300| 6f 6e 66 69 67 75 72 61 | 74 69 6f 6e 43 6f 6d 70 |onfigura|tionComp|
|00006310| 6f 6e 65 6e 74 20 69 6e | 73 74 2c 20 48 61 6e 64 |onent in|st, Hand|
|00006320| 6c 65 20 65 6e 74 72 69 | 65 73 2c 20 6c 6f 6e 67 |le entri|es, long|
|00006330| 20 70 6f 73 2c 20 49 43 | 4d 61 70 45 6e 74 72 79 | pos, IC|MapEntry|
|00006340| 20 2a 65 6e 74 72 79 29 | 0d 46 49 56 45 57 4f 52 | *entry)|.FIVEWOR|
|00006350| 44 49 4e 4c 49 4e 45 28 | 30 78 32 46 33 43 2c 20 |DINLINE(|0x2F3C, |
|00006360| 31 32 2c 20 32 30 2c 20 | 30 78 37 30 30 30 2c 20 |12, 20, |0x7000, |
|00006370| 30 78 41 38 32 41 29 3b | 0d 20 20 2f 2a 20 52 65 |0xA82A);|.  /* Re|
|00006380| 71 75 69 72 65 73 20 49 | 43 20 31 2e 31 2e 0d 20 |quires I|C 1.1.. |
|00006390| 20 20 2a 20 59 6f 75 20 | 6d 75 73 74 20 73 70 65 |  * You |must spe|
|000063a0| 63 69 66 79 20 61 20 63 | 6f 6e 66 69 67 75 72 61 |cify a c|onfigura|
|000063b0| 74 69 6f 6e 20 62 65 66 | 6f 72 65 20 63 61 6c 6c |tion bef|ore call|
|000063c0| 69 6e 67 20 74 68 69 73 | 20 72 6f 75 74 69 6e 65 |ing this| routine|
|000063d0| 2e 0d 20 20 20 2a 20 59 | 6f 75 20 64 6f 20 6e 6f |..   * Y|ou do no|
|000063e0| 74 20 68 61 76 65 20 74 | 6f 20 62 65 20 69 6e 73 |t have t|o be ins|
|000063f0| 69 64 65 20 61 6e 20 49 | 43 42 65 67 69 6e 2f 45 |ide an I|CBegin/E|
+--------+-------------------------+-------------------------+--------+--------+